@wolfstar/plugin-gateway 0.11.0 → 0.12.0-next-20261006120125

package/dist/esm/index.d.ts

@@ -813,6 +813,38 @@ interface Cache<Value extends StructureMixin<object>, Raw extends RawAPIType<Val
    */
   set(key: string, value: Value): Awaitable<this>;
 }
+/**
+ * The cache of the manager of one channel or thread: the keyed methods of the {@link Cache} it reads, taking the ID
+ * of the entity alone instead of the key built by `resolveKey`, like the caches of discord.js's channel managers.
+ *
+ * @typeParam Value The structure the cache hands out.
+ */
+interface ScopedCache<Value extends StructureMixin<object>> {
+  /**
+   * Whether every method answers synchronously, never with a promise.
+   */
+  readonly synchronous: boolean;
+  /**
+   * Deletes an item from the cache.
+   */
+  delete(id: string): Awaitable<boolean>;
+  /**
+   * Retrieves an item from the cache.
+   */
+  get(id: string): Awaitable<Value | undefined>;
+  /**
+   * Checks if an item exists in the cache.
+   */
+  has(id: string): Awaitable<boolean>;
+}
+/**
+ * Scopes a {@link Cache} keyed by more than an ID to the entries of one parent.
+ *
+ * @param cache The cache.
+ * @param resolveKey Builds the key of the cache from the ID of an entity.
+ * @internal
+ */
+declare function scopeCache<Value extends StructureMixin<object>>(cache: Cache<Value>, resolveKey: (id: string) => string): ScopedCache<Value>;
 /**
  * The options of the cache of one entity, set per entity through the client's `cacheOptions` option.
  */
@@ -1047,6 +1079,35 @@ export interface AddOptions {
    */
   extras?: unknown[];
 }
+/**
+ * The arguments of a method of a manager the client holds for every guild: they start with the guild's ID, which a
+ * manager built for one guild (`guild.members`, `client.guilds.members(guildId)`) fills in.
+ *
+ * @typeParam InGuild Whether the manager was built for one guild.
+ * @typeParam Args The arguments after the guild's ID.
+ */
+export type GuildArgs<InGuild extends boolean, Args extends readonly unknown[]> = InGuild extends true ? Args : [guildId: string, ...Args];
+/**
+ * Types the arguments of a method declared with {@link GuildArgs}, which always start with the guild's ID once
+ * {@link fillGuildId} filled it in.
+ *
+ * @param args The arguments of the method.
+ * @internal
+ */
+export declare function withGuildId<Args extends readonly unknown[]>(args: readonly unknown[]): [guildId: string, ...Args];
+/**
+ * Makes methods of a manager the client holds for every guild fill in the guild's ID: on an instance built for one
+ * guild, they call the client's manager, which holds the state and the cache, with that ID first.
+ *
+ * @param target The class of the manager.
+ * @param getManager Gets the client's manager.
+ * @param methods The names of the methods taking the guild's ID first.
+ * @internal
+ */
+export declare function fillGuildId<Manager extends {
+  client: GatewayClient;
+  guildId: string | undefined;
+}>(target: abstract new (...args: any[]) => Manager, getManager: (client: GatewayClient) => object, methods: readonly string[]): void;
 /**
  * Manages the API methods of a data model with a mutable cache of instances: the `CachedManager` of the discord.js
  * RFC #11426.
@@ -1056,13 +1117,16 @@ export interface AddOptions {
  * `cacheConstructor` (`CollectionCache` by default) and shared by every manager of the same entity.
  *
  * Caches keyed by more than an ID take the key built by `resolveKey`:
- * `client.members.cache.get(client.members.resolveKey(guildId, userId))`.
+ * `client.members.cache.get(client.members.resolveKey(guildId, userId))`. The managers of a guild, a channel or a
+ * thread take the ID alone: `guild.members.cache.get(userId)`.
  *
  * @typeParam Name The name of the entity this manager holds.
  * @typeParam Value The structure this manager builds.
  * @typeParam Args The arguments identifying an entity, e.g. `[id]` or `[guildId, userId]`.
+ * @typeParam FetchArgs The arguments `fetch` and `refresh` take, which differ from `Args` on a manager built for one
+ * guild.
  */
-export declare abstract class CachedManager<Name extends CacheEntityName, Value extends StructureMixin<object>, Args extends readonly string[]> extends DataManager<Value, Args> {
+export declare abstract class CachedManager<Name extends CacheEntityName, Value extends StructureMixin<object>, Args extends readonly string[], FetchArgs extends readonly string[] = Args> extends DataManager<Value, Args> {
   /**
    * The cache of this manager's entity.
    *
@@ -1070,6 +1134,12 @@ export declare abstract class CachedManager<Name extends CacheEntityName, Value
    * ```typescript
    * const user = await client.users.cache.get(userId);
    * ```
+   *
+   * @remarks
+   * On a manager built for one guild (`guild.members`), it is the client's cache taking the ID of the entity alone.
+   * `get`, `has`, `set` and `delete` cost the same as on the client's; `getSize` and `clear` scan the keys of every
+   * guild to find the ones of this guild, unlike discord.js's per-guild collections: avoid calling them for every
+   * guild in a loop.
    */
   readonly cache: Cache<Value>;
   /**
@@ -1083,7 +1153,14 @@ export declare abstract class CachedManager<Name extends CacheEntityName, Value
    * @param extras The extra arguments passed to {@link CachedManager._add}.
    */
   protected abstract createStructure(data: CacheEntityTypes[Name], ...extras: unknown[]): Value;
-  constructor(client: GatewayClient, name: Name);
+  /**
+   * @param client The client.
+   * @param name The name of the entity this manager holds.
+   * @param guildId The guild whose entities {@link CachedManager.cache} is narrowed to, for the managers the client
+   * holds for every guild.
+   */
+  constructor(client: GatewayClient, name: Name, guildId?: string);
+  private createGuildCache;
   /**
    * Gets {@link CachedManager.cache} from the client. Managers whose entity spans several caches override it.
    */
@@ -1182,13 +1259,13 @@ export declare abstract class CachedManager<Name extends CacheEntityName, Value
    *
    * @param args The arguments identifying the entity, optionally followed by {@link FetchOptions}.
    */
-  fetch(...args: [...Args] | [...Args, FetchOptions]): Promise<Value>;
+  fetch(...args: [...FetchArgs] | [...FetchArgs, FetchOptions]): Promise<Value>;
   /**
    * Fetches an entity from the API, bypassing and then updating the cache. Same as `fetch(...args, { force: true })`.
    *
    * @param args The arguments identifying the entity.
    */
-  refresh(...args: Args): Promise<Value>;
+  refresh(...args: FetchArgs): Promise<Value>;
   /**
    * Gets the cache key of raw data.
    *
@@ -1807,9 +1884,18 @@ export declare class ThreadMemberManager extends CachedManager<"threadMembers",
  */
 export declare class ThreadChannelMemberManager extends BaseManager {
   readonly threadId: string;
+  /**
+   * The cached members of the thread, by user ID.
+   *
+   * @example
+   * ```typescript
+   * const member = await thread.members.cache.get(userId);
+   * ```
+   */
+  readonly cache: ScopedCache<ThreadMember>;
   constructor(client: GatewayClient, threadId: string);
   /**
-   * Gets a member of the thread from the cache.
+   * Gets a member of the thread from the cache. Same as `cache.get`, always answering a promise.
    */
   get(userId: string): Promise<ThreadMember | undefined>;
   /**
@@ -4499,9 +4585,18 @@ export declare class Message<InGuild extends boolean = boolean> extends Message$
  */
 export declare class ChannelMessageManager extends BaseManager {
   readonly channelId: string;
+  /**
+   * The cached messages of the channel, by message ID.
+   *
+   * @example
+   * ```typescript
+   * const message = await channel.messages.cache.get(messageId);
+   * ```
+   */
+  readonly cache: ScopedCache<Message>;
   constructor(client: GatewayClient, channelId: string);
   /**
-   * Gets a message of the channel from the cache.
+   * Gets a message of the channel from the cache. Same as `cache.get`, always answering a promise.
    */
   get(messageId: string): Promise<Message | undefined>;
   /**
@@ -6262,9 +6357,22 @@ export interface RolePosition {
 }
 /**
  * Manages the {@link Role}s known to the client.
+ *
+ * `guild.roles` (or `client.guilds.roles(guildId)`) is this manager built for one guild, like discord.js's:
+ * `cache` takes the role's ID alone, and the methods lose their `guildId` argument.
+ *
+ * @typeParam InGuild Whether the manager was built for one guild.
  */
-export declare class RoleManager extends CachedManager<"roles", Role, [guildId: string, roleId: string]> {
-  constructor(client: GatewayClient);
+export declare class RoleManager<InGuild extends boolean = false> extends CachedManager<"roles", Role, [guildId: string, roleId: string], GuildArgs<InGuild, [roleId: string]>> {
+  /**
+   * The ID of the guild this manager was built for, `undefined` on `client.roles`.
+   */
+  readonly guildId: InGuild extends true ? string : undefined;
+  /**
+   * @param client The client.
+   * @param guildId The guild to build the manager for.
+   */
+  constructor(client: GatewayClient, guildId?: string);
   protected createStructure(data: CacheEntityTypes["roles"]): Role;
   keyOf(data: CacheEntityTypes["roles"]): string;
   _hydrate(data: CacheEntityTypes["roles"]): Awaitable<Role>;
@@ -6275,21 +6383,21 @@ export declare class RoleManager extends CachedManager<"roles", Role, [guildId:
    * @param guildId The ID of the guild.
    * @returns The roles, highest first.
    */
-  fetchAll(guildId: string): Promise<Role[]>;
+  fetchAll(...args: GuildArgs<InGuild, []>): Promise<Role[]>;
   /**
    * Fetches how many members each role of a guild has, `@everyone` excluded.
    *
    * @param guildId The ID of the guild.
    * @returns The member count of every role, by role ID.
    */
-  fetchMemberCounts(guildId: string): Promise<Map<string, number>>;
+  fetchMemberCounts(...args: GuildArgs<InGuild, []>): Promise<Map<string, number>>;
   /**
    * Creates a role.
    *
    * @param guildId The ID of the guild.
    * @param options The role's fields.
    */
-  create(guildId: string, options?: RoleEditOptions): Promise<Role>;
+  create(...args: GuildArgs<InGuild, [options?: RoleEditOptions]>): Promise<Role>;
   /**
    * Edits a role.
    *
@@ -6297,7 +6405,7 @@ export declare class RoleManager extends CachedManager<"roles", Role, [guildId:
    * @param roleId The ID of the role.
    * @param options The fields to edit.
    */
-  edit(guildId: string, roleId: string, options: RoleEditOptions): Promise<Role>;
+  edit(...args: GuildArgs<InGuild, [roleId: string, options: RoleEditOptions]>): Promise<Role>;
   /**
    * Deletes a role.
    *
@@ -6305,7 +6413,7 @@ export declare class RoleManager extends CachedManager<"roles", Role, [guildId:
    * @param roleId The ID of the role.
    * @param reason The reason for the audit log.
    */
-  delete(guildId: string, roleId: string, reason?: string): Promise<void>;
+  delete(...args: GuildArgs<InGuild, [roleId: string, reason?: string]>): Promise<void>;
   /**
    * Moves a role among the roles of its guild, like discord.js's `RoleManager#setPosition`.
    *
@@ -6316,7 +6424,7 @@ export declare class RoleManager extends CachedManager<"roles", Role, [guildId:
    * @param options Whether the position is relative and the reason for the audit log, or the reason alone.
    * @returns Every role of the guild, highest first.
    */
-  setPosition(guildId: string, roleId: string, position: number, options?: SetPositionOptions | string): Promise<Role[]>;
+  setPosition(...args: GuildArgs<InGuild, [roleId: string, position: number, options?: SetPositionOptions | string]>): Promise<Role[]>;
   /**
    * Moves several roles at once.
    *
@@ -6325,7 +6433,7 @@ export declare class RoleManager extends CachedManager<"roles", Role, [guildId:
    * @param reason The reason for the audit log.
    * @returns Every role of the guild, highest first.
    */
-  setPositions(guildId: string, positions: readonly RolePosition[], reason?: string): Promise<Role[]>;
+  setPositions(...args: GuildArgs<InGuild, [positions: readonly RolePosition[], reason?: string]>): Promise<Role[]>;
   /**
    * Compares the positions of two roles.
    *
@@ -6337,26 +6445,26 @@ export declare class RoleManager extends CachedManager<"roles", Role, [guildId:
    *
    * @param guildId The ID of the guild.
    */
-  everyone(guildId: string): Promise<Role>;
+  everyone(...args: GuildArgs<InGuild, []>): Promise<Role>;
   /**
    * Fetches the highest role of a guild.
    *
    * @param guildId The ID of the guild.
    */
-  highest(guildId: string): Promise<Role | null>;
+  highest(...args: GuildArgs<InGuild, []>): Promise<Role | null>;
   /**
    * Fetches the role Discord gives to the server boosters of a guild, if any.
    *
    * @param guildId The ID of the guild.
    */
-  premiumSubscriberRole(guildId: string): Promise<Role | null>;
+  premiumSubscriberRole(...args: GuildArgs<InGuild, []>): Promise<Role | null>;
   /**
    * Fetches the role Discord manages for a bot in a guild, if any.
    *
    * @param guildId The ID of the guild.
    * @param botId The ID of the bot user.
    */
-  botRoleFor(guildId: string, botId: string): Promise<Role | null>;
+  botRoleFor(...args: GuildArgs<InGuild, [botId: string]>): Promise<Role | null>;
   protected fetchRaw(guildId: string, roleId: string): Promise<{
     id: import("discord-api-types/globals").Snowflake;
     name: string;
@@ -7272,10 +7380,23 @@ export interface GuildMembersRequestOptions {
 }
 /**
  * Manages the {@link GuildMember}s known to the client.
+ *
+ * `guild.members` (or `client.guilds.members(guildId)`) is this manager built for one guild, like discord.js's:
+ * `cache` takes the user's ID alone, and the methods lose their `guildId` argument.
+ *
+ * @typeParam InGuild Whether the manager was built for one guild.
  */
-export declare class GuildMemberManager extends CachedManager<"members", GuildMember, [guildId: string, userId: string]> {
+export declare class GuildMemberManager<InGuild extends boolean = false> extends CachedManager<"members", GuildMember, [guildId: string, userId: string], GuildArgs<InGuild, [userId: string]>> {
   #private;
-  constructor(client: GatewayClient);
+  /**
+   * The ID of the guild this manager was built for, `undefined` on `client.members`.
+   */
+  readonly guildId: InGuild extends true ? string : undefined;
+  /**
+   * @param client The client.
+   * @param guildId The guild to build the manager for.
+   */
+  constructor(client: GatewayClient, guildId?: string);
   protected createStructure(data: CacheEntityTypes["members"]): GuildMember;
   keyOf(data: CacheEntityTypes["members"]): string;
   /**
@@ -7297,39 +7418,42 @@ export declare class GuildMemberManager extends CachedManager<"members", GuildMe
   private readRelation;
   resolveKey(guildId: string, userId: string): string;
   /**
-   * Gets the bot's own member in a guild from the cache, like discord.js's `guild.members.me`. Synchronous when the
-   * member cache is. Use {@link GuildMemberManager.fetchMe} to fall back to the API.
+   * The bot's own member in a guild, from the cache: `null` when it is not cached. Use
+   * {@link GuildMemberManager.fetchMe} to fall back to the API.
    *
-   * @param guildId The ID of the guild.
-   * @returns The member, or `null` when it is not cached.
+   * @remarks
+   * On the manager of a guild it is a getter, like discord.js's `guild.members.me`: the member itself, or a promise
+   * of it with an asynchronous cache (see `GatewayCacheConfig`). On `client.members` it is a function taking the
+   * guild's ID, synchronous when the member cache is.
    */
-  me(guildId: string): Awaitable<GuildMember | null>;
+  readonly me: InGuild extends true ? CacheRead<GuildMember | null> : (guildId: string) => Awaitable<GuildMember | null>;
+  private cachedMe;
   /**
    * Fetches the bot's own member in a guild, cache first.
    *
    * @param guildId The ID of the guild.
    */
-  fetchMe(guildId: string): Promise<GuildMember>;
+  fetchMe(...args: GuildArgs<InGuild, []>): Promise<GuildMember>;
   /**
    * Lists the members of a guild, in user ID order, and caches them.
    *
    * @param guildId The ID of the guild.
    * @param options How many members to list (up to 1000), and after which user ID.
    */
-  list(guildId: string, options?: {
+  list(...args: GuildArgs<InGuild, [options?: {
     limit?: number;
     after?: string;
-  }): Promise<GuildMember[]>;
+  }]>): Promise<GuildMember[]>;
   /**
    * Searches the members of a guild whose username or nickname starts with a query, and caches them.
    *
    * @param guildId The ID of the guild.
    * @param options The query, and how many members to return (up to 1000).
    */
-  search(guildId: string, options: {
+  search(...args: GuildArgs<InGuild, [options: {
     query: string;
     limit?: number;
-  }): Promise<GuildMember[]>;
+  }]>): Promise<GuildMember[]>;
   /**
    * Requests the members of a guild over the gateway, every one of them by default, and caches them. discord.js:
    * `guild.members.fetch()` without a user.
@@ -7343,7 +7467,7 @@ export declare class GuildMemberManager extends CachedManager<"members", GuildMe
    * @param options Which members to request.
    * @returns The members, once the last chunk is cached.
    */
-  request(guildId: string, options?: GuildMembersRequestOptions): Promise<GuildMember[]>;
+  request(...args: GuildArgs<InGuild, [options?: GuildMembersRequestOptions]>): Promise<GuildMember[]>;
   /**
    * Adds a cached chunk of members to the request with its nonce, resolving it with the last chunk.
    *
@@ -7363,7 +7487,7 @@ export declare class GuildMemberManager extends CachedManager<"members", GuildMe
    * @param userId The ID of the user.
    * @param options The access token and the member's initial state.
    */
-  add(guildId: string, userId: string, options: GuildMemberAddOptions): Promise<GuildMember>;
+  add(...args: GuildArgs<InGuild, [userId: string, options: GuildMemberAddOptions]>): Promise<GuildMember>;
   /**
    * Edits a member.
    *
@@ -7371,14 +7495,14 @@ export declare class GuildMemberManager extends CachedManager<"members", GuildMe
    * @param userId The ID of the member's user.
    * @param options The fields to edit.
    */
-  edit(guildId: string, userId: string, options: GuildMemberEditOptions): Promise<GuildMember>;
+  edit(...args: GuildArgs<InGuild, [userId: string, options: GuildMemberEditOptions]>): Promise<GuildMember>;
   /**
    * Edits the bot's own member.
    *
    * @param guildId The ID of the guild.
    * @param options The fields to edit.
    */
-  editMe(guildId: string, options: GuildMemberEditMeOptions): Promise<GuildMember>;
+  editMe(...args: GuildArgs<InGuild, [options: GuildMemberEditMeOptions]>): Promise<GuildMember>;
   /**
    * Kicks a member.
    *
@@ -7386,7 +7510,7 @@ export declare class GuildMemberManager extends CachedManager<"members", GuildMe
    * @param userId The ID of the member's user.
    * @param reason The reason for the audit log.
    */
-  kick(guildId: string, userId: string, reason?: string): Promise<void>;
+  kick(...args: GuildArgs<InGuild, [userId: string, reason?: string]>): Promise<void>;
   /**
    * Bans a user, member or not.
    *
@@ -7394,7 +7518,7 @@ export declare class GuildMemberManager extends CachedManager<"members", GuildMe
    * @param userId The ID of the user.
    * @param options How many seconds of messages to delete, and the reason for the audit log.
    */
-  ban(guildId: string, userId: string, options?: BanOptions): Promise<void>;
+  ban(...args: GuildArgs<InGuild, [userId: string, options?: BanOptions]>): Promise<void>;
   /**
    * Lifts a user's ban.
    *
@@ -7402,7 +7526,7 @@ export declare class GuildMemberManager extends CachedManager<"members", GuildMe
    * @param userId The ID of the user.
    * @param reason The reason for the audit log.
    */
-  unban(guildId: string, userId: string, reason?: string): Promise<void>;
+  unban(...args: GuildArgs<InGuild, [userId: string, reason?: string]>): Promise<void>;
   /**
    * Bans up to 200 users at once.
    *
@@ -7411,7 +7535,7 @@ export declare class GuildMemberManager extends CachedManager<"members", GuildMe
    * @param options How many seconds of messages to delete, and the reason for the audit log.
    * @returns The users that were banned, and the ones that could not be.
    */
-  bulkBan(guildId: string, userIds: readonly string[], options?: BanOptions): Promise<{
+  bulkBan(...args: GuildArgs<InGuild, [userIds: readonly string[], options?: BanOptions]>): Promise<{
     bannedUsers: string[];
     failedUsers: string[];
   }>;
@@ -7422,7 +7546,7 @@ export declare class GuildMemberManager extends CachedManager<"members", GuildMe
    * @param options The inactivity threshold and the roles to include.
    * @returns How many members were (or would be) pruned, `null` when `count` is `false`.
    */
-  prune(guildId: string, options?: GuildPruneOptions): Promise<number | null>;
+  prune(...args: GuildArgs<InGuild, [options?: GuildPruneOptions]>): Promise<number | null>;
   /**
    * Adds a role to a member.
    *
@@ -7431,7 +7555,7 @@ export declare class GuildMemberManager extends CachedManager<"members", GuildMe
    * @param roleId The ID of the role.
    * @param reason The reason for the audit log.
    */
-  addRole(guildId: string, userId: string, roleId: string, reason?: string): Promise<void>;
+  addRole(...args: GuildArgs<InGuild, [userId: string, roleId: string, reason?: string]>): Promise<void>;
   /**
    * Removes a role from a member.
    *
@@ -7440,7 +7564,7 @@ export declare class GuildMemberManager extends CachedManager<"members", GuildMe
    * @param roleId The ID of the role.
    * @param reason The reason for the audit log.
    */
-  removeRole(guildId: string, userId: string, roleId: string, reason?: string): Promise<void>;
+  removeRole(...args: GuildArgs<InGuild, [userId: string, roleId: string, reason?: string]>): Promise<void>;
   protected fetchRaw(guildId: string, userId: string): Promise<{
     nick?: string | null;
     roles: import("discord-api-types/globals").Snowflake[];
@@ -8121,6 +8245,128 @@ export declare class GuildInviteManager extends CachedManager<"invites", GuildIn
   private toCached;
 }
 //#endregion
+//#region src/managers/PresenceManager.d.ts
+/**
+ * Manages the presences of guild members.
+ *
+ * @remarks
+ * Presences only come from the gateway, with the `GuildPresences` intent: there is no API to fetch them, so `fetch`
+ * rejects on a cache miss. Use `cache.get`, which answers `undefined` instead.
+ *
+ * The cache is keyed by guild and user. `guild.presences` (or `client.guilds.presences(guildId)`) reads it by user
+ * ID alone, like discord.js: `guild.presences.cache.get(userId)`.
+ *
+ * `guild.presences` (or `client.guilds.presences(guildId)`) is this manager built for one guild, like discord.js's:
+ * `cache` takes the user's ID alone, and the methods lose their `guildId` argument.
+ *
+ * @typeParam InGuild Whether the manager was built for one guild.
+ */
+export declare class PresenceManager<InGuild extends boolean = false> extends CachedManager<"presences", Presence, [guildId: string, userId: string], GuildArgs<InGuild, [userId: string]>> {
+  /**
+   * The ID of the guild this manager was built for, `undefined` on `client.presences`.
+   */
+  readonly guildId: InGuild extends true ? string : undefined;
+  /**
+   * @param client The client.
+   * @param guildId The guild to build the manager for.
+   */
+  constructor(client: GatewayClient, guildId?: string);
+  protected createStructure(data: CacheEntityTypes["presences"]): Presence;
+  keyOf(data: CacheEntityTypes["presences"]): string;
+  resolveKey(guildId: string, userId: string): string;
+  _hydrate(data: CacheEntityTypes["presences"]): Awaitable<Presence>;
+  /**
+   * Resolves a {@link PresenceResolvable} to the cached presence of its user in a guild.
+   *
+   * @remarks
+   * A string is a **user ID**, not a cache key: read `guild.presences.cache.get(userId)`, or build the key with
+   * {@link PresenceManager.resolveKey} to read `cache.get` directly. It is a pure cache read, no request is made and
+   * a miss is `null`; presences only come from the gateway.
+   *
+   * The guild comes from a member or a message, else from a thread member's member or thread, and otherwise from
+   * `guildId`. A message sent in a direct message belongs to no guild, so it resolves to `null` unless `guildId` is
+   * given.
+   *
+   * @param presence The presence, something holding a user, or a user ID.
+   * @param guildId The guild to look the presence up in, when the value carries none.
+   * @returns The presence, or `null` if it is not cached or its guild is unknown.
+   */
+  resolve(presence: PresenceResolvable, guildId?: string): Awaitable<Presence | null>;
+  /**
+   * Resolves a {@link PresenceResolvable} to a user ID.
+   *
+   * @remarks
+   * This is the ID of the presence's user, like discord.js, and not the cache key {@link PresenceManager.resolveKey}
+   * builds from a guild and a user.
+   *
+   * @param presence The presence, something holding a user, or a user ID.
+   * @returns The user ID, or `null` if the value holds none.
+   */
+  resolveId(presence: PresenceResolvable): string | null;
+  private guildOf;
+  /**
+   * Lists the cached presences of a guild.
+   *
+   * @param guildId The ID of the guild.
+   * @returns The cached entries, `[]` when this entity is not cached.
+   * @throws {TypeError} When the store cannot enumerate its entries.
+   */
+  listCached(...args: GuildArgs<InGuild, []>): Promise<Presence[]>;
+  protected fetchRaw(guildId: string, userId: string): Promise<CacheEntityTypes["presences"]>;
+}
+//#endregion
+//#region src/managers/VoiceStateManager.d.ts
+/**
+ * Manages the voice states of the members connected to voice channels.
+ *
+ * @remarks
+ * The cache holds them when the bot has the `GuildVoiceStates` intent. `fetch` falls back to the API, which only
+ * knows the voice states of connected members.
+ *
+ * `guild.voiceStates` (or `client.guilds.voiceStates(guildId)`) is this manager built for one guild, like
+ * discord.js's: `cache` takes the user's ID alone, and the methods lose their `guildId` argument.
+ *
+ * @typeParam InGuild Whether the manager was built for one guild.
+ */
+export declare class VoiceStateManager<InGuild extends boolean = false> extends CachedManager<"voiceStates", VoiceState, [guildId: string, userId: string], GuildArgs<InGuild, [userId: string]>> {
+  /**
+   * The ID of the guild this manager was built for, `undefined` on `client.voiceStates`.
+   */
+  readonly guildId: InGuild extends true ? string : undefined;
+  /**
+   * @param client The client.
+   * @param guildId The guild to build the manager for.
+   */
+  constructor(client: GatewayClient, guildId?: string);
+  protected createStructure(data: CacheEntityTypes["voiceStates"]): VoiceState;
+  keyOf(data: CacheEntityTypes["voiceStates"]): string;
+  resolveKey(guildId: string, userId: string): string;
+  _hydrate(data: CacheEntityTypes["voiceStates"]): Awaitable<VoiceState>;
+  /**
+   * Lists the cached voice states of a guild.
+   *
+   * @param guildId The ID of the guild.
+   * @returns The cached entries, `[]` when this entity is not cached.
+   * @throws {TypeError} When the store cannot enumerate its entries.
+   */
+  listCached(...args: GuildArgs<InGuild, []>): Promise<VoiceState[]>;
+  protected fetchRaw(guildId: string, userId: string): Promise<{
+    channel_id: import("discord-api-types/globals").Snowflake | null;
+    user_id: import("discord-api-types/globals").Snowflake;
+    member?: import("discord-api-types/v10").APIGuildMember;
+    session_id: string;
+    deaf: boolean;
+    mute: boolean;
+    self_deaf: boolean;
+    self_mute: boolean;
+    self_stream?: boolean;
+    self_video: boolean;
+    suppress: boolean;
+    request_to_speak_timestamp: string | null;
+    guild_id: string;
+  }>;
+}
+//#endregion
 //#region src/managers/GuildManager.d.ts
 /**
  * Until when to pause invites and direct messages in a guild, at most 24 hours ahead; `null` resumes them.
@@ -8385,6 +8631,30 @@ export declare class GuildManager extends CachedManager<"guilds", Guild, [guildI
    * @param guildId The ID of the guild.
    */
   invites(guildId: string): GuildInviteManager;
+  /**
+   * Gets the manager of a guild's presences.
+   *
+   * @param guildId The ID of the guild.
+   */
+  presences(guildId: string): PresenceManager<true>;
+  /**
+   * Gets the manager of a guild's members.
+   *
+   * @param guildId The ID of the guild.
+   */
+  members(guildId: string): GuildMemberManager<true>;
+  /**
+   * Gets the manager of a guild's roles.
+   *
+   * @param guildId The ID of the guild.
+   */
+  roles(guildId: string): RoleManager<true>;
+  /**
+   * Gets the manager of a guild's voice states.
+   *
+   * @param guildId The ID of the guild.
+   */
+  voiceStates(guildId: string): VoiceStateManager<true>;
   /**
    * Lists the guilds the bot is in, as the partial guilds the API returns, paginated by guild ID.
    *
@@ -8954,6 +9224,22 @@ export declare class Guild extends AnonymousGuild<CacheEntityTypes["guilds"]> {
    * The invites of the guild.
    */
   get invites(): GuildInviteManager;
+  /**
+   * The presences of the guild: `guild.presences.cache.get(userId)`.
+   */
+  get presences(): PresenceManager<true>;
+  /**
+   * The members of the guild: `guild.members.cache.get(userId)`.
+   */
+  get members(): GuildMemberManager<true>;
+  /**
+   * The roles of the guild: `guild.roles.cache.get(roleId)`.
+   */
+  get roles(): RoleManager<true>;
+  /**
+   * The voice states of the guild: `guild.voiceStates.cache.get(userId)`.
+   */
+  get voiceStates(): VoiceStateManager<true>;
   /**
    * Gets the URL of the guild's discovery splash image, or `null` if it has none.
    * @param options The image options.
@@ -10041,99 +10327,6 @@ export declare class ChannelManager extends CachedManager<"channels", AnyChannel
   protected fetchRaw(channelId: string): Promise<import("discord-api-types/v10").APIChannel>;
 }
 //#endregion
-//#region src/managers/VoiceStateManager.d.ts
-/**
- * Manages the voice states of the members connected to voice channels.
- *
- * @remarks
- * The cache holds them when the bot has the `GuildVoiceStates` intent. `fetch` falls back to the API, which only
- * knows the voice states of connected members.
- */
-export declare class VoiceStateManager extends CachedManager<"voiceStates", VoiceState, [guildId: string, userId: string]> {
-  constructor(client: GatewayClient);
-  protected createStructure(data: CacheEntityTypes["voiceStates"]): VoiceState;
-  keyOf(data: CacheEntityTypes["voiceStates"]): string;
-  resolveKey(guildId: string, userId: string): string;
-  _hydrate(data: CacheEntityTypes["voiceStates"]): Awaitable<VoiceState>;
-  /**
-   * Lists the cached voice states of a guild.
-   *
-   * @param guildId The ID of the guild.
-   * @returns The cached entries, `[]` when this entity is not cached.
-   * @throws {TypeError} When the store cannot enumerate its entries.
-   */
-  listCached(guildId: string): Promise<VoiceState[]>;
-  protected fetchRaw(guildId: string, userId: string): Promise<{
-    channel_id: import("discord-api-types/globals").Snowflake | null;
-    user_id: import("discord-api-types/globals").Snowflake;
-    member?: import("discord-api-types/v10").APIGuildMember;
-    session_id: string;
-    deaf: boolean;
-    mute: boolean;
-    self_deaf: boolean;
-    self_mute: boolean;
-    self_stream?: boolean;
-    self_video: boolean;
-    suppress: boolean;
-    request_to_speak_timestamp: string | null;
-    guild_id: string;
-  }>;
-}
-//#endregion
-//#region src/managers/PresenceManager.d.ts
-/**
- * Manages the presences of guild members.
- *
- * @remarks
- * Presences only come from the gateway, with the `GuildPresences` intent: there is no API to fetch them, so `fetch`
- * rejects on a cache miss. Use `cache.get`, which answers `undefined` instead.
- */
-export declare class PresenceManager extends CachedManager<"presences", Presence, [guildId: string, userId: string]> {
-  constructor(client: GatewayClient);
-  protected createStructure(data: CacheEntityTypes["presences"]): Presence;
-  keyOf(data: CacheEntityTypes["presences"]): string;
-  resolveKey(guildId: string, userId: string): string;
-  _hydrate(data: CacheEntityTypes["presences"]): Awaitable<Presence>;
-  /**
-   * Resolves a {@link PresenceResolvable} to the cached presence of its user in a guild.
-   *
-   * @remarks
-   * A string is a **user ID**, not a cache key: build the key with {@link PresenceManager.resolveKey} to read
-   * `cache.get` directly. It is a pure cache read, no request is made and a miss is `null`; presences only come from
-   * the gateway.
-   *
-   * The guild comes from a member or a message, else from a thread member's member or thread, and otherwise from
-   * `guildId`. A message sent in a direct message belongs to no guild, so it resolves to `null` unless `guildId` is
-   * given.
-   *
-   * @param presence The presence, something holding a user, or a user ID.
-   * @param guildId The guild to look the presence up in, when the value carries none.
-   * @returns The presence, or `null` if it is not cached or its guild is unknown.
-   */
-  resolve(presence: PresenceResolvable, guildId?: string): Awaitable<Presence | null>;
-  /**
-   * Resolves a {@link PresenceResolvable} to a user ID.
-   *
-   * @remarks
-   * This is the ID of the presence's user, like discord.js, and not the cache key {@link PresenceManager.resolveKey}
-   * builds from a guild and a user.
-   *
-   * @param presence The presence, something holding a user, or a user ID.
-   * @returns The user ID, or `null` if the value holds none.
-   */
-  resolveId(presence: PresenceResolvable): string | null;
-  private guildOf;
-  /**
-   * Lists the cached presences of a guild.
-   *
-   * @param guildId The ID of the guild.
-   * @returns The cached entries, `[]` when this entity is not cached.
-   * @throws {TypeError} When the store cannot enumerate its entries.
-   */
-  listCached(guildId: string): Promise<Presence[]>;
-  protected fetchRaw(guildId: string, userId: string): Promise<CacheEntityTypes["presences"]>;
-}
-//#endregion
 //#region src/managers/UserManager.d.ts
 /**
  * The options to open a direct message channel with.
@@ -12660,5 +12853,5 @@ export interface TransformedResolvedData {
  */
 export declare function transformResolved({ client, guildId }: SupportingResolvedData, { users, members, roles, channels }: ResolvableData): Awaitable<TransformedResolvedData>;
 //#endregion
-export { type AllowedPartial, type AnnouncementChannelResolvable, type ApplicationCommandDataResolvable, type ApplicationCommandPermissionIdResolvable, type ApplicationCommandResolvable, type ApplicationResolvable, type AttachmentPayload, type AttachmentResolvable, type AutoModerationRuleResolvable, type BaseMessageOptions, BitField, type BitFieldResolvable, type BufferResolvable, type Cache, type CacheConstructor, type CacheConstructorOptions, type CacheEntityOptions, type CacheRead, type CacheReadOf, type CategoryChannelResolvable, type ChannelResolvable, type ColorResolvable, type CommandOptionDataTypeResolvable, type ComponentEmojiResolvable, type DateResolvable, type EmojiResolvable, type EntitlementResolvable, type ForwardOptions, type GatewayCacheConfig, type GatewayClientMessageDefaults, type GuildAuditLogsResolvable, type GuildBanResolvable, type GuildBasedChannel, type GuildChannelResolvable, type GuildInvitableChannel, type GuildInvitableChannelResolvable, type GuildInviteResolvable, type GuildResolvable, type GuildScheduledEventResolvable, type GuildSearchMessagesOptions, type GuildSearchMessagesResult, type GuildTemplateResolvable, type GuildTextBasedChannel, type GuildTextChannelResolvable, type GuildVoiceChannelResolvable, type HexColorString, type If, type InviteResolvable, type JSONEncodable, type MessageActionRowComponentResolvable, type MessageCreateOptions, type MessageEditOptions, type MessageMentionOptions, type MessagePayloadContext, type MessagePayloadOptions, type MessagePayloadResolvable, type MessageReactionResolvable, type MessageResolvable, type MessageTarget, type NonThreadGuildBasedChannel, type OverwriteResolvable, type Partialize, type PermissionOverwriteResolvable, PermissionsBitField, type PollCreateData, type PresenceResolvable, type RawAPIType, type ReplyOptions, type ResolvedMessagePayload, type RoleColorsEditResolvable, type RoleColorsResolvable, type RoleResolvable, type RoleResolvables, type SKUResolvable, type SoundboardSoundResolvable, type StageChannelResolvable, type StageInstanceResolvable, type StickerResolvable, type StructureCreator, type SubscriptionResolvable, type TextBasedChannel, type TextBasedChannelResolvable, type TextChannelResolvable, type ThreadChannel, type ThreadChannelResolvable, type ThreadMemberResolvable, type UserResolvable, type VoiceBasedChannel, type VoiceChannelResolvable, type WebhookMessageCreateOptions, type WebhookMessageEditOptions, type WebhookMessageOptions, type WebhookThreadOptions, type cacheRead, type cachedChannel, type cachedGuild, type cachedMember, type cachedMessage, type cachedPresence, type cachedRole, type cachedUser, type cachedVoiceState, type isPromiseLike, type peekCache, type pickCached, type readCached, type refreshRelations, type syncOnly, type whenAll, type whenCachedMap };
+export { type AllowedPartial, type AnnouncementChannelResolvable, type ApplicationCommandDataResolvable, type ApplicationCommandPermissionIdResolvable, type ApplicationCommandResolvable, type ApplicationResolvable, type AttachmentPayload, type AttachmentResolvable, type AutoModerationRuleResolvable, type BaseMessageOptions, BitField, type BitFieldResolvable, type BufferResolvable, type Cache, type CacheConstructor, type CacheConstructorOptions, type CacheEntityOptions, type CacheRead, type CacheReadOf, type CategoryChannelResolvable, type ChannelResolvable, type ColorResolvable, type CommandOptionDataTypeResolvable, type ComponentEmojiResolvable, type DateResolvable, type EmojiResolvable, type EntitlementResolvable, type ForwardOptions, type GatewayCacheConfig, type GatewayClientMessageDefaults, type GuildAuditLogsResolvable, type GuildBanResolvable, type GuildBasedChannel, type GuildChannelResolvable, type GuildInvitableChannel, type GuildInvitableChannelResolvable, type GuildInviteResolvable, type GuildResolvable, type GuildScheduledEventResolvable, type GuildSearchMessagesOptions, type GuildSearchMessagesResult, type GuildTemplateResolvable, type GuildTextBasedChannel, type GuildTextChannelResolvable, type GuildVoiceChannelResolvable, type HexColorString, type If, type InviteResolvable, type JSONEncodable, type MessageActionRowComponentResolvable, type MessageCreateOptions, type MessageEditOptions, type MessageMentionOptions, type MessagePayloadContext, type MessagePayloadOptions, type MessagePayloadResolvable, type MessageReactionResolvable, type MessageResolvable, type MessageTarget, type NonThreadGuildBasedChannel, type OverwriteResolvable, type Partialize, type PermissionOverwriteResolvable, PermissionsBitField, type PollCreateData, type PresenceResolvable, type RawAPIType, type ReplyOptions, type ResolvedMessagePayload, type RoleColorsEditResolvable, type RoleColorsResolvable, type RoleResolvable, type RoleResolvables, type SKUResolvable, type ScopedCache, type SoundboardSoundResolvable, type StageChannelResolvable, type StageInstanceResolvable, type StickerResolvable, type StructureCreator, type SubscriptionResolvable, type TextBasedChannel, type TextBasedChannelResolvable, type TextChannelResolvable, type ThreadChannel, type ThreadChannelResolvable, type ThreadMemberResolvable, type UserResolvable, type VoiceBasedChannel, type VoiceChannelResolvable, type WebhookMessageCreateOptions, type WebhookMessageEditOptions, type WebhookMessageOptions, type WebhookThreadOptions, type cacheRead, type cachedChannel, type cachedGuild, type cachedMember, type cachedMessage, type cachedPresence, type cachedRole, type cachedUser, type cachedVoiceState, type isPromiseLike, type peekCache, type pickCached, type readCached, type refreshRelations, type scopeCache, type syncOnly, type whenAll, type whenCachedMap };
 //# sourceMappingURL=index.d.ts.map