@stoatx/client 0.3.0 → 0.5.0

package/dist/index.d.cts

@@ -1,4 +1,7 @@
 import { EventEmitter } from 'events';
+import { APIRoutes, File, User as User$1, Member as Member$1, Channel, Message as Message$1, Role as Role$1, Invite, ServerBan as ServerBan$1, Server as Server$1, Emoji as Emoji$1, Category, Embed } from 'stoat-api';
+import * as stoatApi from 'stoat-api';
+export { stoatApi as API };
 import * as util from 'node:util';
 
 declare class GatewayManager {
@@ -18,6 +21,40 @@ declare class GatewayManager {
     disconnect(): void;
 }
 
+type CDNTag = "attachments" | "avatars" | "backgrounds" | "icons" | "banners" | "emojis";
+declare class AttachmentBuilder {
+    readonly filename: string | undefined;
+    readonly file: Buffer | Blob;
+    /**
+     * Creates a new AttachmentBuilder with the given file and optional filename.
+     * @param file The file data as a Buffer or Blob.
+     * @param filename An optional filename to use for the uploaded file. If not provided, the CDN will assign a default name.
+     *                 Providing a filename can help with organization and debugging, but is not strictly required.
+     * @example
+     * // Create an attachment from a Buffer with a custom filename
+     * const buffer = Buffer.from("Hello, world!");
+     * const attachment = new AttachmentBuilder(buffer, "greeting.txt");
+     */
+    constructor(file: Buffer | Blob, filename?: string);
+    /**
+     * Uploads this attachment to the Stoat CDN and returns the resulting file ID.
+     * @internal — use `resolveAttachment()` instead of calling this directly.
+     */
+    upload(rest: RESTManager, tag: CDNTag): Promise<string>;
+}
+
+type ValidPath<M extends APIRoutes["method"]> = Extract<APIRoutes, {
+    method: M;
+}>["path"];
+type RouteResponse<M extends APIRoutes["method"], P extends string> = Extract<APIRoutes, {
+    method: M;
+    path: P;
+}>["response"];
+type RouteParams<M extends APIRoutes["method"], P extends string> = Extract<APIRoutes, {
+    method: M;
+    path: P;
+}>["params"];
+
 /**
  * Custom Error class for Stoat API failures
  */
@@ -41,17 +78,17 @@ declare class RESTManager {
      * Generates a local identifier for the bucket based on method and path.
      */
     private getRouteKey;
-    makeRequest(method: string, endpoint: string, body?: any): Promise<any>;
+    makeRequest<M extends APIRoutes["method"], P extends ValidPath<M>>(method: M, endpoint: P, params?: RouteParams<M, P>): Promise<RouteResponse<M, P>>;
     private execute;
     /**
      * Uploads a file to Stoat's CDN and returns the File ID
      */
-    uploadFile(filename: string, fileBuffer: Buffer | Blob): Promise<string>;
-    get(endpoint: string): Promise<any>;
-    post(endpoint: string, body?: any): Promise<any>;
-    patch(endpoint: string, body?: any): Promise<any>;
-    delete(endpoint: string, body?: any): Promise<any>;
-    put(endpoint: string, body?: any): Promise<any>;
+    uploadFile(tag: CDNTag, fileBuffer: Buffer | Blob, filename?: string): Promise<string>;
+    get<P extends ValidPath<"get">>(endpoint: P, params?: RouteParams<"get", P>): Promise<RouteResponse<"get", P>>;
+    post<P extends ValidPath<"post">>(endpoint: P, params?: RouteParams<"post", P>): Promise<RouteResponse<"post", P>>;
+    patch<P extends ValidPath<"patch">>(endpoint: P, params?: RouteParams<"patch", P>): Promise<RouteResponse<"patch", P>>;
+    delete<P extends ValidPath<"delete">>(endpoint: P, params?: RouteParams<"delete", P>): Promise<RouteResponse<"delete", P>>;
+    put<P extends ValidPath<"put">>(endpoint: P, params?: RouteParams<"put", P>): Promise<RouteResponse<"put", P>>;
 }
 
 /**
@@ -61,7 +98,7 @@ declare abstract class Base {
     readonly id: string;
     cachedAt: number;
     protected readonly client: Client;
-    constructor(client: Client, data: {
+    protected constructor(client: Client, data: {
         _id: string;
     });
     /**
@@ -88,8 +125,8 @@ type AttachmentMetadata = {
     type: "Image";
     width: number;
     height: number;
-    thumbhash?: number[];
-    animated?: boolean;
+    thumbhash?: number[] | null;
+    animated?: boolean | null;
 } | {
     type: "Video";
     width: number;
@@ -104,11 +141,11 @@ declare class Attachment extends Base {
     size: number;
     deleted?: boolean;
     reported?: boolean;
-    messageId?: string;
-    userId?: string;
-    serverId?: string;
-    objectId?: string;
-    constructor(client: Client, data: any);
+    messageId?: string | null | undefined;
+    userId?: string | null | undefined;
+    serverId?: string | null | undefined;
+    objectId?: string | null | undefined;
+    constructor(client: Client, data: File);
     /**
      * Automatically constructs the direct CDN URL for this file
      */
@@ -119,29 +156,12 @@ declare class Attachment extends Base {
     get isImage(): boolean;
 }
 
-declare enum UserRelationship {
-    None = "None",
-    User = "User",
-    Friend = "Friend",
-    Outgoing = "Outgoing",
-    Incoming = "Incoming",
-    Blocked = "Blocked",
-    BlockedOther = "BlockedOther"
-}
-declare enum UserPresence {
-    Online = "Online",
-    Idle = "Idle",
-    Focus = "Focus",
-    Busy = "Busy",
-    Invisible = "Invisible"
-}
+type UserRelationShip = "None" | "User" | "Friend" | "Outgoing" | "Incoming" | "Blocked" | "BlockedOther";
 interface BotInformation {
     owner: string;
 }
-interface UserStatus {
-    presence: UserPresence;
-    text?: string | null;
-}
+type UserStatus = NonNullable<User$1["status"]>;
+type UserPresence = NonNullable<UserStatus["presence"]>;
 interface UserProfile {
     background?: string | null;
     content?: string | null;
@@ -149,7 +169,7 @@ interface UserProfile {
 declare class User extends Base {
     discriminator: string;
     online: boolean;
-    relationship: UserRelationship;
+    relationship: UserRelationShip;
     username: string;
     avatar?: Attachment | null;
     badges?: number;
@@ -158,8 +178,8 @@ declare class User extends Base {
     flags?: number;
     privileged?: boolean;
     status?: UserStatus | null;
-    constructor(client: Client, data: any);
-    _patch(data: any, clear?: string[]): void;
+    constructor(client: Client, data: User$1);
+    _patch(data: User$1, clear?: string[]): void;
     /**
      * Convenience getter to return the user's tag (username#discriminator)
      */
@@ -249,7 +269,8 @@ interface MemberBanOptions {
     deleteMessageSeconds?: number;
 }
 interface FetchMembersOptions {
-    exclude_offline?: boolean;
+    /** Whether to exclude offline users from the fetch */
+    excludeOffline?: boolean;
 }
 declare class MemberManager extends BaseManager<string, Member> {
     server: Server;
@@ -258,12 +279,12 @@ declare class MemberManager extends BaseManager<string, Member> {
      * Tell BaseManager how to handle Revolt's Member IDs
      * @internal
      */
-    protected extractId(data: any): string;
+    protected extractId(data: Member$1): string;
     /**
      * Tell BaseManager how to build a Member
      * @internal
      */
-    protected construct(data: any): Member;
+    protected construct(data: Member$1): Member;
     /**
      * Resolve a string or mention to Member
      * @param member The MemberResolvable to resolve
@@ -346,6 +367,141 @@ declare class MemberManager extends BaseManager<string, Member> {
     [util.inspect.custom](): Collection<string, Member>;
 }
 
+type BitFieldResolvable = number | string | bigint | BitField | BitFieldResolvable[];
+declare class BitField {
+    static Flags: Record<string, number | bigint>;
+    static DefaultBit: number | bigint;
+    bitfield: number | bigint;
+    constructor(bits?: BitFieldResolvable);
+    /**
+     * Checks whether this bitfield has any of the given bits set.
+     *
+     * @param bit The bit(s) to test against.
+     * @returns `true` if at least one of the provided bits is set.
+     *
+     * @example
+     * perms.any(['SendMessage', 'ManageChannel']); // true if either is set
+     */
+    any(bit: BitFieldResolvable): boolean;
+    /**
+     * Checks whether this bitfield is exactly equal to the given bit value.
+     *
+     * @param bit The bit(s) to compare against.
+     * @returns `true` if the resolved bit value is identical to this bitfield.
+     *
+     * @example
+     * new Permissions(0n).equals(0n); // true
+     */
+    equals(bit: BitFieldResolvable): boolean;
+    /**
+     * Checks whether this bitfield has *all* of the given bits set.
+     *
+     * @param bit The bit(s) to check for.
+     * @returns `true` if every provided bit is set in this bitfield.
+     *
+     * @example
+     * perms.has('SendMessage');
+     * perms.has(['SendMessage', 'ViewChannel']); // true only if both are set
+     */
+    has(bit: BitFieldResolvable, ..._hasParams: any[]): boolean;
+    /**
+     * Returns the flag names present in `bits` that are *missing* from this bitfield.
+     *
+     * @param bits The bits to check against.
+     * @returns An array of flag name strings that are in `bits` but not in this bitfield.
+     *
+     * @example
+     * // If perms only has SendMessage:
+     * perms.missing(['SendMessage', 'ManageChannel']); // ['ManageChannel']
+     */
+    missing(bits: BitFieldResolvable, ...hasParams: any[]): string[];
+    /**
+     * Freezes this BitField instance, making it immutable.
+     * Subsequent calls to `add()` or `remove()` will return a new instance instead of mutating this one.
+     *
+     * @returns This instance, frozen.
+     */
+    freeze(): Readonly<this>;
+    /**
+     * Adds one or more bits to this bitfield.
+     * If the instance is frozen, returns a new BitField with the bits added.
+     *
+     * @param bits The bit(s) to add.
+     * @returns This instance (or a new one if frozen), with the bits added.
+     *
+     * @example
+     * perms.add('SendMessage', 'ViewChannel');
+     */
+    add(...bits: BitFieldResolvable[]): this;
+    /**
+     * Removes one or more bits from this bitfield.
+     * If the instance is frozen, returns a new BitField with the bits removed.
+     *
+     * @param bits The bit(s) to remove.
+     * @returns This instance (or a new one if frozen), with the bits cleared.
+     *
+     * @example
+     * perms.remove('ManageChannel');
+     */
+    remove(...bits: BitFieldResolvable[]): this;
+    /**
+     * Serializes this bitfield to a plain object mapping each flag name to a boolean
+     * indicating whether that flag is set.
+     *
+     * @returns A record of `{ [flagName]: boolean }` for all defined flags.
+     *
+     * @example
+     * perms.serialize();
+     * // { SendMessage: true, ManageChannel: false, ... }
+     */
+    serialize(...hasParams: any[]): Record<string, boolean>;
+    /**
+     * Returns an array of flag names that are set in this bitfield.
+     *
+     * @returns An array of string flag names.
+     *
+     * @example
+     * perms.toArray(); // ['SendMessage', 'ViewChannel']
+     */
+    toArray(...hasParams: any[]): string[];
+    /**
+     * Returns the bitfield value as a JSON-safe primitive.
+     * Numbers are returned as-is; bigints are converted to their string representation
+     * to avoid JSON serialization errors.
+     */
+    toJSON(): number | string;
+    /**
+     * Returns the underlying numeric value of this bitfield.
+     * Allows BitField instances to be used directly in arithmetic expressions.
+     */
+    valueOf(): number | bigint;
+    /**
+     * Iterates over the names of all flags that are set in this bitfield.
+     *
+     * @example
+     * for (const flag of perms) {
+     *   console.log(flag); // 'SendMessage', 'ViewChannel', etc.
+     * }
+     */
+    [Symbol.iterator](...hasParams: any[]): IterableIterator<string>;
+    /**
+     * Resolves a {@link BitFieldResolvable} into a raw `number | bigint`.
+     *
+     * Resolution rules (in order):
+     * - `undefined` → `DefaultBit`
+     * - A number or bigint matching `DefaultBit`'s type and >= 0 → returned as-is
+     * - A `BitField` instance → its `.bitfield` value
+     * - An array → each element resolved and OR'd together
+     * - A numeric string → parsed as `BigInt` or `Number` depending on `DefaultBit`'s type
+     * - A named string flag → looked up in `Flags`
+     * - Anything else → throws `RangeError`
+     *
+     * @param bit The value to resolve.
+     * @throws {RangeError} If the value cannot be resolved to a valid bit.
+     */
+    static resolve(bit?: BitFieldResolvable): number | bigint;
+}
+
 declare const PermissionFlags: {
     readonly ManageChannel: bigint;
     readonly ManageServer: bigint;
@@ -383,26 +539,32 @@ declare const PermissionFlags: {
     readonly GrantAllSafe: 4503599627370495n;
 };
 type PermissionString = keyof typeof PermissionFlags;
-type PermissionResolvable = bigint | PermissionString | PermissionResolvable[];
-declare class Permissions {
-    /**
-     * Converts a string, BigInt, or array of strings into a single BigInt
-     */
-    static resolve(permission: PermissionResolvable): bigint;
-    /**
-     * Checks if a specific permission bit exists
-     */
-    static has(totalPermissions: bigint, permissionToCheck: PermissionResolvable): boolean;
+type PermissionResolvable = PermissionString | bigint | number | Permissions | PermissionResolvable[];
+declare class Permissions extends BitField {
+    static Flags: Record<string, number | bigint>;
+    static DefaultBit: bigint;
+    static resolve(bit?: PermissionResolvable): bigint;
+    has(bit: PermissionResolvable): boolean;
+    any(bit: PermissionResolvable): boolean;
+    missing(bits: PermissionResolvable): PermissionString[];
+    add(...bits: PermissionResolvable[]): this;
+    remove(...bits: PermissionResolvable[]): this;
 }
 
+type RawDMChannel = Extract<Channel, {
+    channel_type: "DirectMessage";
+}>;
 declare class DMChannel extends BaseChannel {
     active: boolean;
     recipients: string[];
     lastMessageId: string | null;
-    constructor(client: any, data: any);
-    _patch(data: any): void;
+    constructor(client: Client, data: RawDMChannel);
+    _patch(data: RawDMChannel): void;
 }
 
+type RawGroupChannel = Extract<Channel, {
+    channel_type: "Group";
+}>;
 declare class GroupChannel extends BaseChannel {
     name: string;
     ownerId: string;
@@ -411,8 +573,8 @@ declare class GroupChannel extends BaseChannel {
     icon: Attachment | null;
     lastMessageId?: string | null;
     nsfw: boolean;
-    constructor(client: Client, data: any);
-    _patch(data: any, clear?: string[]): void;
+    constructor(client: Client, data: RawGroupChannel);
+    _patch(data: RawGroupChannel, clear?: string[]): void;
     /** Gets the User object of the person who owns this group */
     get owner(): User | undefined;
     /** Resolves the recipient IDs into an array of cached User objects */
@@ -443,11 +605,11 @@ declare class UserManager extends BaseManager<string, User> {
     /**
      * Tell BaseManager how to find the ID for Users
      */
-    protected extractId(data: any): string;
+    protected extractId(data: User$1): string;
     /**
      * Tell BaseManager how to build a User
      */
-    protected construct(data: any): User;
+    protected construct(data: User$1): User;
     /**
      * Resolves a UserResolvable to a User object from the cache.
      */
@@ -547,11 +709,11 @@ declare class MessageManager extends BaseManager<string, Message> {
     /**
      * Tell BaseManager how to find the ID for Messages
      */
-    protected extractId(data: any): string;
+    protected extractId(data: Message$1): string;
     /**
      * Tell BaseManager how to build a Message
      */
-    protected construct(data: any): Message;
+    protected construct(data: Message$1): Message;
     fetch(id: string): Promise<Message>;
     /**
      * Fetches multiple messages from the channel using specific filter parameters.
@@ -639,7 +801,7 @@ interface ChannelEditOptions {
     name?: string;
     description?: string | null;
     owner?: string;
-    icon?: string | null;
+    icon?: string | AttachmentBuilder | null;
     nsfw?: boolean;
     archived?: boolean;
     voice?: {
@@ -658,8 +820,8 @@ declare class ChannelManager extends BaseManager<string, BaseChannel> {
      * @param limit The maximum number of channels to hold in the cache.
      */
     constructor(client: Client, limit?: number);
-    protected extractId(data: any): string;
-    protected construct(data: any): BaseChannel;
+    protected extractId(data: Channel): string;
+    protected construct(data: Channel): BaseChannel;
     /**
      * Resolves a ChannelResolvable to a cached BaseChannel object.
      * @param channel The ChannelResolvable to resolve.
@@ -763,21 +925,24 @@ declare class ChannelManager extends BaseManager<string, BaseChannel> {
     bulkDelete(id: string, messages: MessageResolvable[]): Promise<void>;
 }
 
+type RawTextChannel = Extract<Channel, {
+    channel_type: "TextChannel";
+}>;
 declare class TextChannel extends BaseChannel {
     name: string;
     serverId: string;
     defaultPermissions?: {
         a: number;
         d: number;
-    };
-    description?: string | null;
+    } | null | undefined;
+    description?: string | null | undefined;
     icon?: Attachment | null;
-    lastMessageId?: string | null;
+    lastMessageId?: string | null | undefined;
     nsfw?: boolean;
     slowmode?: number;
     voice?: any;
-    constructor(client: Client, data: any);
-    _patch(data: any, clear?: string[]): void;
+    constructor(client: Client, data: RawTextChannel);
+    _patch(data: RawTextChannel, clear?: string[]): void;
     /**
      * Updates the permission overrides for the channel.
      * @param roleId The raw string ID of the role to update.
@@ -971,11 +1136,7 @@ declare class MessageCollector extends Collector<string, Message> {
     endReason(): string | null;
 }
 
-declare enum ChannelType {
-    TEXT = "TextChannel",
-    DM = "DirectMessage",
-    GROUP = "Group"
-}
+type ChannelType = "SavedMessages" | "DirectMessage" | "Group" | "TextChannel";
 interface ChannelCreateOptions {
     name: string;
     type: "Text" | "Voice";
@@ -988,7 +1149,7 @@ interface ChannelCreateOptions {
 declare abstract class BaseChannel extends Base {
     type: ChannelType;
     messages: MessageManager;
-    protected constructor(client: Client, data: any);
+    protected constructor(client: Client, data: Channel);
     /**
      * Sends a message to this channel.
      * @param contentOrOptions The string content or message options payload.
@@ -1101,27 +1262,26 @@ declare class ServerChannelManager {
 declare class Role extends Base {
     serverId: string;
     name: string;
-    color: string | null;
+    color: string | null | undefined;
     hoist: boolean;
     rank: number;
-    permissions: bigint;
-    constructor(client: Client, data: any, serverId: string);
+    icon: Attachment | null;
+    private _permissions;
+    constructor(client: Client, data: Role$1, serverId: string);
     /**
      * Updates the role instance with new data without losing the object reference.
      * @internal
      */
-    _patch(data: any): void;
+    _patch(data: Role$1): void;
     /**
      * The server this role belongs to.
      * Pulls dynamically from the cache to prevent massive memory duplication.
      */
     get server(): Server | undefined;
     /**
-     * Checks whether this role has a specific permission.
-     * @param permission The permission to check for.
-     * @returns True if the role has the permission.
+     * Permissions for this role
      */
-    hasPermission(permission: PermissionResolvable): boolean;
+    get permissions(): Permissions;
     /**
      * Fetches this role directly from the API to ensure data is up to date.
      * @param force Whether to skip the cache check and force a direct API request. Defaults to false.
@@ -1133,7 +1293,7 @@ declare class Role extends Base {
      * await role.fetch();
      * console.log(`Role updated, current name: ${role.name}`);
      */
-    fetch(force?: boolean): Promise<this>;
+    fetch(force?: boolean): Promise<Role>;
     /**
      * Edits the role with the given options. Only the fields provided in the options will be updated; all other fields will remain unchanged.
      * @param options The fields to update.
@@ -1142,12 +1302,12 @@ declare class Role extends Base {
      * @throws {Error} If the API request fails (e.g., lack of permissions).
      * @example
      * // Change the role's name and color
-     * await role.edit({ name: "Senior Admin", colour: "#FFD700" });
+     * await role.edit({ name: "Senior Admin", color: "#FFD700" });
      *
      * // Remove the custom color from the role
-     * await role.edit({ colour: null });
+     * await role.edit({ color: null });
      */
-    edit(options: RoleEditOptions): Promise<this>;
+    edit(options: RoleEditOptions): Promise<Role>;
     /**
      * Deletes this Role from the server.
      * @throws {Error} If the role cannot be deleted (e.g., lack of permissions).
@@ -1168,7 +1328,7 @@ declare class Role extends Base {
      *   allow: ["ManageChannel", "SendMessage"]
      * });
      */
-    setPermissions(options: RolePermissionOptions): Promise<this>;
+    setPermissions(options: RolePermissionOptions): Promise<Role>;
     /**
      * Updates the hierarchical position of this role.
      * Automatically reconstructs the role array and performs a bulk update.
@@ -1180,7 +1340,66 @@ declare class Role extends Base {
      * await role.setPosition(2);
      * console.log(`Role moved to rank: ${role.rank}`);
      */
-    setPosition(newPosition: number): Promise<this>;
+    setPosition(newPosition: number): Promise<Role>;
+    /**
+     * Change the name for this role
+     * @param name The new name for the role
+     * @returns A promise that resolves to this updated Role object.
+     * @throws {Error} If API request fails.
+     * @example
+     * // Change the role's name
+     * await role.setName("New Role Name");
+     * console.log(`Role's new name: ${role.name}`);
+     */
+    setName(name: string): Promise<Role>;
+    /**
+     * Change the color for this role, it can be a HEX or CSS colours
+     * @param {[string]} color The new color for the role
+     * @returns A promise that resolves to this updated Role object.
+     * @throws {Error} If API request fails
+     * @example
+     * // Change the role's color
+     * await role.setColour("#FF0000");
+     * console.log(`Role's new color: ${role.color}`);
+     *
+     * // Use CSS color linear-graident
+     * await role.setColour("linear-gradient(90deg, #FF0000, #0000FF)");
+     * console.log(`Role's new color: ${role.color}`);
+     *
+     * // Remove the custom color from the role
+     * await role.setColour(null);
+     * console.log(`Role's color removed, current color: ${role.color}`);
+     */
+    setColor(color: string | null): Promise<Role>;
+    /**
+     * Edit the icon of this role
+     * @param icon Autumn ID for the new icon, or null to remove the custom icon
+     * @returns A promise that resolves to this updated Role object.
+     * @throws {Error} If API request fails
+     * @example
+     * // Set a new icon for the role
+     * await role.setIcon("AUTUMN_ID_FOR_ICON");
+     * console.log(`Role's new icon: ${role.icon}`);
+     *
+     * // Use AttachmentBuilder to upload a new icon file
+     * import { readFile } from "node:fs/promises";
+     * const iconFile = await readFile("./a.jpg");
+     * const attachment = new AttachmentBuilder(iconFile, "a.jpg");
+     * await role.setIcon(attachment);
+     * console.log(`Role's new icon: ${role.icon}`);
+     */
+    setIcon(icon: string | AttachmentBuilder | null): Promise<Role>;
+    /**
+     * Change the hoist status for this role
+     * @param hoist The new hoist status for the role
+     * @returns A promise that resolves to this updated Role object.
+     * @throws {Error} If API request fails
+     * @example
+     * // Enable hoisting for the role
+     * await role.setHoist(true);
+     * console.log(`Role is now hoisted: ${role.hoist}`);
+     */
+    setHoist(hoist: boolean): Promise<Role>;
     /**
      * Customizer for Node.js `console.log` and `util.inspect`.
      * Hides the cyclic client reference and raw serverId for a cleaner output.
@@ -1194,8 +1413,9 @@ interface RoleCreateOptions {
 }
 interface RoleEditOptions {
     name?: string;
-    colour?: string | null;
+    color?: string | null;
     hoist?: boolean;
+    icon?: string | AttachmentBuilder | null;
 }
 interface RolePermissionOptions {
     allow?: PermissionResolvable;
@@ -1211,11 +1431,11 @@ declare class RoleManager extends BaseManager<string, Role> {
     /**
      * Tell BaseManager how to find the ID for Roles
      */
-    protected extractId(data: any): string;
+    protected extractId(data: Role$1): string;
     /**
      * Tell BaseManager how to build a Role
      */
-    protected construct(data: any): Role;
+    protected construct(data: Role$1): Role;
     /**
      * Adds or updates a role in the local cache.
      * @internal
@@ -1223,7 +1443,7 @@ declare class RoleManager extends BaseManager<string, Role> {
      * @param idParam An optional ID parameter if the payload wraps the role object.
      * @returns The newly created or updated Role object.
      */
-    _add(data: any, idParam?: string): Role;
+    _add(data: Role$1, idParam?: string): Role;
     [util.inspect.custom](): Collection<string, Role>;
     /**
      * Resolves a RoleResolvable to a Role object from the cache.
@@ -1273,7 +1493,7 @@ declare class RoleManager extends BaseManager<string, Role> {
     fetch(role: RoleResolvable, force?: boolean): Promise<Role>;
     /**
      * Edits an existing role in the server.
-     * @param role The RoleResolvable to edit.
+     * @param role The {@link RoleResolvable} to edit.
      * @param options The fields to update.
      * @returns A promise that resolves to the updated Role.
      * @throws {TypeError} If invalid options or RoleResolvable are provided.
@@ -1338,15 +1558,15 @@ declare class ServerInvite {
     code: string;
     creatorId: string;
     channelId: string;
-    constructor(data: any);
-    _patch(data: any): void;
+    constructor(data: Invite);
+    _patch(data: Invite): void;
 }
 
 declare class ServerInviteManager extends BaseManager<string, ServerInvite> {
     server: Server;
     constructor(client: Client, server: Server, limit?: number);
-    protected extractId(data: any): string;
-    protected construct(data: any): ServerInvite;
+    protected extractId(data: Invite): string;
+    protected construct(data: Invite): ServerInvite;
     /**
      * Fetches all active invites for this server.
      */
@@ -1356,8 +1576,8 @@ declare class ServerInviteManager extends BaseManager<string, ServerInvite> {
 declare class ServerBan {
     userId: string;
     reason: string | null;
-    constructor(data: any);
-    _patch(data: any): void;
+    constructor(data: ServerBan$1);
+    _patch(data: ServerBan$1): void;
 }
 
 declare class ServerBanManager extends BaseManager<string, ServerBan> {
@@ -1402,11 +1622,11 @@ declare class ServerManager extends BaseManager<string, Server> {
     /**
      * Tell BaseManager how to find the ID for Servers
      */
-    protected extractId(data: any): string;
+    protected extractId(data: Server$1): string;
     /**
      * Tell BaseManager how to build a Server
      */
-    protected construct(data: any): Server;
+    protected construct(data: Server$1): Server;
     /**
      * Fetches a server from the API.
      * @param id The server ID.
@@ -1417,18 +1637,20 @@ declare class ServerManager extends BaseManager<string, Server> {
     [util.inspect.custom](): Collection<string, Server>;
 }
 
-interface EmojiParent {
-    id: string;
+type EmojiParent = {
     type: "Server";
-}
+    id: string;
+} | {
+    type: "Detached";
+};
 declare class Emoji extends Base {
     creatorId: string;
     name: string;
     parent: EmojiParent;
     animated: boolean;
     nsfw: boolean;
-    constructor(client: Client, data: any);
-    _patch(data: any): void;
+    constructor(client: Client, data: Emoji$1);
+    _patch(data: Emoji$1): void;
 }
 
 declare class EmojiManager extends BaseManager<string, Emoji> {
@@ -1446,11 +1668,6 @@ declare class EmojiManager extends BaseManager<string, Emoji> {
     [util.inspect.custom](): Collection<string, Emoji>;
 }
 
-interface Categories {
-    channels: string[];
-    id: string;
-    title: string;
-}
 declare class Server extends Base {
     channelIds: string[];
     defaultPermissions: bigint;
@@ -1458,7 +1675,7 @@ declare class Server extends Base {
     ownerId: string;
     analytics: boolean;
     banner: Attachment | null;
-    categories: Categories[];
+    categories: Category[] | null;
     description: string | null;
     discoverable: boolean;
     flags: number;
@@ -1470,11 +1687,11 @@ declare class Server extends Base {
     bans: ServerBanManager;
     invites: ServerInviteManager;
     emojis: EmojiManager;
-    constructor(client: Client, data: any);
+    constructor(client: Client, data: Server$1);
     /**
      * Updates the server instance with new data without losing the object reference.
      */
-    _patch(data: any, clear?: string[]): void;
+    _patch(data: Server$1, clear?: string[]): void;
     /**
      * Edits this server.
      * @param options The fields to update.
@@ -1483,7 +1700,7 @@ declare class Server extends Base {
     /**
      * Leaves the server
      */
-    leave(): Promise<any>;
+    leave(): Promise<never>;
     /**
      * Fetches multiple members from this server.
      * @param options Filter options for the fetch request.
@@ -1541,8 +1758,8 @@ declare class Member extends Base {
     canPublish: boolean;
     canRecieve: boolean;
     roles: MemberRoleManager;
-    constructor(client: Client, data: any);
-    _patch(data: any): void;
+    constructor(client: Client, data: Member$1, serverId?: string);
+    _patch(data: Member$1): void;
     /**
      * Get member role IDs
      */
@@ -1552,7 +1769,7 @@ declare class Member extends Base {
     /** Gets the Server object this member belongs to */
     get server(): Server | undefined;
     /** Calculates the member's total permissions using BigInt */
-    get permissions(): bigint;
+    get permissions(): Permissions;
     /** Get avatar URL for this member, or null if they don't have one.
      * @example
      * // Get a member's avatar URL
@@ -1599,8 +1816,6 @@ declare class Member extends Base {
      */
     send(options: string | MessageOptions): Promise<Message>;
     setNickname(nickname: string): Promise<Member>;
-    /** Checks if the member has a specific permission */
-    hasPermission(permission: PermissionResolvable): boolean;
     /**
      * Edit this member.
      * @param options The options to edit the member with (nickname, roles, timeout, etc.)
@@ -1692,16 +1907,16 @@ declare class ReactionCollector extends Collector<string, MessageReaction> {
 interface MessageOptions {
     content?: string;
     embeds?: (TextEmbedData | EmbedBuilder)[];
-    attachments?: string[];
+    attachments?: string[] | AttachmentBuilder[];
     interactions?: any[];
     flags?: number;
     masquerade?: Masquerade;
     replies?: ReplyIntent[];
 }
 interface Masquerade {
-    avatar?: string;
-    name?: string;
-    colour?: string;
+    avatar?: string | null;
+    name?: string | null;
+    colour?: string | null;
 }
 interface ReplyIntent {
     id: string;
@@ -1716,19 +1931,19 @@ declare class Message extends Base {
     content: string | null;
     authorId: string;
     channelId: string;
-    embeds: any[];
+    embeds: Embed[] | null;
     attachments: Attachment[];
     editedAt: Date | null;
     createdAt: Date | null;
     flags: number;
     interactions: Interaction | null;
     masquerade: Masquerade | null;
-    mentions: string[];
-    pinned: boolean;
+    mentions: string[] | null;
+    pinned: null | boolean;
     reactions: Record<string, string[]>;
-    replies: string[];
-    role_mentions: string[];
-    constructor(client: Client, data: any);
+    replies: string[] | null;
+    role_mentions: string[] | null;
+    constructor(client: Client, data: Message$1);
     reply(contentOrOptions: string | MessageOptions): Promise<Message>;
     /**
      * Edits this message.
@@ -1810,7 +2025,7 @@ declare class Message extends Base {
     get serverId(): string | undefined;
     /** Gets the Server object from cache */
     get server(): Server | undefined;
-    _patch(data: any): void;
+    _patch(data: Message$1): void;
     [util.inspect.custom](depth: number, options: util.InspectOptions, inspect: typeof util.inspect): string;
 }
 
@@ -1818,7 +2033,7 @@ declare class Message extends Base {
  * Represents the authenticated bot's user object.
  */
 declare class ClientUser extends User {
-    constructor(client: Client, data: any);
+    constructor(client: Client, data: User$1);
 }
 
 interface SweeperOptions {
@@ -1868,7 +2083,18 @@ interface ClientEvents {
     serverDelete: [server: Server | string];
     userUpdate: [oldUser: User, newUser: User];
     serverMemberJoin: [member: Member];
-    serverMemberLeave: [member: Member];
+    serverMemberLeave: [member: Member | {
+        serverId: string;
+        userId: string;
+    }];
+    serverBanAdd: [member: Member | {
+        serverId: string;
+        userId: string;
+    }];
+    serverMemberKick: [member: Member | {
+        serverId: string;
+        userId: string;
+    }];
 }
 interface ClientOptions {
     sweepers?: SweeperOptions;
@@ -1903,7 +2129,7 @@ declare class Client extends EventEmitter {
  * A fallback class for channel types that are not yet officially supported by the library.
  */
 declare class UnknownChannel extends BaseChannel {
-    constructor(client: Client, data: any);
+    constructor(client: Client, data: Channel);
 }
 
-export { Attachment, type AttachmentMetadata, Base, BaseChannel, type BotInformation, type Categories, type ChannelCreateOptions, type ChannelEditOptions, ChannelManager, type ChannelResolvable, type ChannelRolePermissionOptions, ChannelType, Client, type ClientEvents, type ClientOptions, ClientUser, Collection, Collector, type CollectorOptions, DMChannel, EmbedBuilder, Emoji, EmojiManager, type EmojiParent, type FetchMembersOptions, GatewayManager, type Interaction, type Masquerade, Member, type MemberBanOptions, type MemberEditOptions, MemberManager, type MemberResolvable, Message, MessageCollector, type MessageCollectorOptions, type MessageFetchOptions, MessageManager, type MessageOptions, MessageReaction, type MessageResolvable, PermissionFlags, type PermissionResolvable, type PermissionString, Permissions, RESTManager, ReactionCollector, type ReactionCollectorOptions, type ReplyIntent, Role, type RoleCreateOptions, type RoleEditOptions, RoleManager, type RolePermissionOptions, type RoleResolvable, Server, ServerChannelManager, type ServerEditOptions, ServerManager, StoatAPIError, SweeperManager, type SweeperOptions, TextChannel, type TextEmbedData, UnknownChannel, User, type UserEditOptions, UserManager, UserPresence, type UserProfile, UserRelationship, type UserResolvable, type UserStatus };
+export { Attachment, AttachmentBuilder, type AttachmentMetadata, Base, BaseChannel, BitField, type BitFieldResolvable, type BotInformation, type CDNTag, type ChannelCreateOptions, type ChannelEditOptions, ChannelManager, type ChannelResolvable, type ChannelRolePermissionOptions, type ChannelType, Client, type ClientEvents, type ClientOptions, ClientUser, Collection, Collector, type CollectorOptions, DMChannel, EmbedBuilder, Emoji, EmojiManager, type EmojiParent, type FetchMembersOptions, GatewayManager, type Interaction, type Masquerade, Member, type MemberBanOptions, type MemberEditOptions, MemberManager, type MemberResolvable, Message, MessageCollector, type MessageCollectorOptions, type MessageFetchOptions, MessageManager, type MessageOptions, MessageReaction, type MessageResolvable, PermissionFlags, type PermissionResolvable, type PermissionString, Permissions, RESTManager, type RawDMChannel, type RawTextChannel, ReactionCollector, type ReactionCollectorOptions, type ReplyIntent, Role, type RoleCreateOptions, type RoleEditOptions, RoleManager, type RolePermissionOptions, type RoleResolvable, Server, ServerChannelManager, type ServerEditOptions, ServerManager, StoatAPIError, SweeperManager, type SweeperOptions, TextChannel, type TextEmbedData, UnknownChannel, User, type UserEditOptions, UserManager, type UserPresence, type UserProfile, type UserRelationShip, type UserResolvable, type UserStatus };