@stoatx/client 0.6.4 → 0.7.0

package/dist/index.d.cts

@@ -8,6 +8,7 @@ import util__default from 'node:util';
 declare class GatewayManager {
     private client;
     private ws;
+    private wsURL;
     private pingInterval;
     private token;
     private reconnectAttempts;
@@ -15,6 +16,7 @@ declare class GatewayManager {
     private isIntentionalClose;
     constructor(client: Client);
     connect(token: string): Promise<void>;
+    setGatewayUrl(url: string): void;
     private handleMessage;
     private startPingLoop;
     private send;
@@ -71,10 +73,13 @@ declare class StoatAPIError extends Error {
 declare class RESTManager {
     private client;
     private baseURL;
+    private cdnURL;
     private token;
     private buckets;
     constructor(client: Client);
     setToken(token: string): void;
+    setBaseURL(baseURL: string): void;
+    setCDNURL(cdnURL: string): void;
     /**
      * Generates a local identifier for the bucket based on method and path.
      */
@@ -1652,20 +1657,109 @@ declare class Emoji extends Base {
     nsfw: boolean;
     constructor(client: Client, data: Emoji$1);
     _patch(data: Emoji$1): void;
+    /**
+     * Fetch this emoji from the API or resolves it from the local cache.
+     * @param force Whether to skip the cache check and force a direct API request. Defaults to false.
+     * @returns A promise that resolves to the fetched {@link Emoji} object.
+     * @throws {Error} If the API request fails or if the emoji is detached.
+     * @example
+     * // Force fetch emoji to update its data
+     * await emoji.fetch(true);
+     */
+    fetch(force?: boolean): Promise<Emoji>;
+    /**
+     * Deletes this emoji from the server.
+     * @returns A promise that resolves when the emoji has been deleted.
+     * @throws {Error} If the API request fails or if the emoji is detached.
+     * @example
+     * // Delete an emoji from the server
+     * await emoji.delete();
+     */
+    delete(): Promise<void>;
+    /**
+     * Edits this emoji's properties.
+     * @param options The options to edit the emoji with.
+     * @returns A promise that resolves to the edited {@link Emoji} object.
+     * @throws {Error} If the API request fails or if the emoji is detached.
+     * @example
+     * // Edit an emoji's name
+     * await emoji.edit({ name: "new_name" });
+     */
+    edit(options: EmojiEditOptions): Promise<Emoji>;
 }
 
+interface EmojiCreateOptions {
+    emoji: string | AttachmentBuilder;
+    name: string;
+    nsfw?: boolean;
+}
+interface EmojiEditOptions {
+    name: string;
+}
+type EmojiResolvable = string | Emoji;
 declare class EmojiManager extends BaseManager<string, Emoji> {
     server?: Server | undefined;
     constructor(client: Client, server?: Server | undefined, limit?: number);
     /**
      * Tell BaseManager how to find the ID for Emojis
      */
-    protected extractId(data: any): string;
+    protected extractId(data: Emoji$1): string;
     /**
      * Tell BaseManager how to build an Emoji
      */
-    protected construct(data: any): Emoji;
-    fetch(id: string): Promise<Emoji>;
+    protected construct(data: Emoji$1): Emoji;
+    /**
+     * Fetch an Emoji from the API or resolves it from the local cache.
+     * @param emoji The ID, mention, or {@link Emoji} object to fetch
+     * @param force Whether to skip the cache check and force a direct API request. Defaults to false.
+     * @returns A promise that resolves to the fetched {@link Emoji} object.
+     * @throws {TypeError} If an invalid {@link EmojiResolvable} is provided.
+     * @throws {Error} If the API request fails.
+     * @example
+     * // Fetch a channel, bypassing cache
+     * const channel = await client.channels.fetch("01H...", true);
+     */
+    fetch(emoji: EmojiResolvable, force?: boolean): Promise<Emoji>;
+    /**
+     * Resolves a {@link EmojiResolvable} to a {@link Emoji} object from the cache.
+     * @param emoji The {@link EmojiResolvable} to resolve.
+     * @returns The resolved {@link Emoji} object, or undefined if not found.
+     */
+    resolve(emoji: EmojiResolvable): Emoji | undefined;
+    /**
+     * Extracts ID from a {@link EmojiResolvable}.
+     * @param emoji The {@link EmojiResolvable} to extract the ID from.
+     * @returns The extracted {@link Emoji} ID.
+     * @throws {TypeError} If an invalid type is provided.
+     */
+    resolveId(emoji: EmojiResolvable): string;
+    /**
+     * Create a new emoji
+     * @param options The options for creating the emoji
+     * @returns A promise that resolves to the created {@link Emoji} object.
+     * @throws {Error} If no server is registered in the {@link EmojiManager} or if the emoji attachment cannot be resolved.
+     * @example
+     * const emoji = await client.emojis.create(server, { emoji: "path/to/emoji.png", name: "myEmoji" });
+     */
+    crate(options: EmojiCreateOptions): Promise<Emoji>;
+    /**
+     * Delete an emoji
+     * @param emoji The {@link EmojiResolvable} to delete
+     * @throws {Error} If no server is registered in the {@link EmojiManager}.
+     * @example
+     * await client.emojis.delete(emoji);
+     */
+    delete(emoji: EmojiResolvable): Promise<void>;
+    /**
+     * Edit an emoji
+     * @param emoji The {@link EmojiResolvable} to edit
+     * @param options The options to edit the emoji with
+     * @returns A promise that resolves to the edited {@link Emoji} object.
+     * @throws {Error} If no server is registered in the {@link EmojiManager}.
+     * @example
+     * const editedEmoji = await client.emojis.edit(emoji, { name: "newName" });
+     */
+    edit(emoji: EmojiResolvable, options: EmojiEditOptions): Promise<Emoji>;
     [util.inspect.custom](): Collection<string, Emoji>;
 }
 
@@ -2131,9 +2225,13 @@ interface ClientOptions {
         channels?: number;
         emojis?: number;
     };
+    apiURL?: string;
+    overrides?: {
+        wsURL?: string;
+        cdnURL?: string;
+    };
 }
 declare class Client extends EventEmitter {
-    options: ClientOptions;
     rest: RESTManager;
     gateway: GatewayManager;
     channels: ChannelManager;
@@ -2142,11 +2240,13 @@ declare class Client extends EventEmitter {
     sweepers: SweeperManager;
     emojis: EmojiManager;
     user: ClientUser | null;
+    options: ClientOptions;
     constructor(options?: ClientOptions);
     /**
      * Connects the bot to the Stoat Gateway
      */
     login(token: string): Promise<any>;
+    private fetchConfig;
     on<K extends keyof ClientEvents>(event: K, listener: (...args: ClientEvents[K]) => void): this;
     once<K extends keyof ClientEvents>(event: K, listener: (...args: ClientEvents[K]) => void): this;
     emit<K extends keyof ClientEvents>(event: K, ...args: ClientEvents[K]): boolean;
@@ -2159,4 +2259,4 @@ declare class UnknownChannel extends BaseChannel {
     constructor(client: Client, data: Channel);
 }
 
-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, GroupChannel, 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 RawGroupChannel, 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 };
+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, type EmojiCreateOptions, type EmojiEditOptions, EmojiManager, type EmojiParent, type EmojiResolvable, type FetchMembersOptions, GatewayManager, GroupChannel, 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 RawGroupChannel, 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 };

package/dist/index.d.ts

@@ -8,6 +8,7 @@ import util__default from 'node:util';
 declare class GatewayManager {
     private client;
     private ws;
+    private wsURL;
     private pingInterval;
     private token;
     private reconnectAttempts;
@@ -15,6 +16,7 @@ declare class GatewayManager {
     private isIntentionalClose;
     constructor(client: Client);
     connect(token: string): Promise<void>;
+    setGatewayUrl(url: string): void;
     private handleMessage;
     private startPingLoop;
     private send;
@@ -71,10 +73,13 @@ declare class StoatAPIError extends Error {
 declare class RESTManager {
     private client;
     private baseURL;
+    private cdnURL;
     private token;
     private buckets;
     constructor(client: Client);
     setToken(token: string): void;
+    setBaseURL(baseURL: string): void;
+    setCDNURL(cdnURL: string): void;
     /**
      * Generates a local identifier for the bucket based on method and path.
      */
@@ -1652,20 +1657,109 @@ declare class Emoji extends Base {
     nsfw: boolean;
     constructor(client: Client, data: Emoji$1);
     _patch(data: Emoji$1): void;
+    /**
+     * Fetch this emoji from the API or resolves it from the local cache.
+     * @param force Whether to skip the cache check and force a direct API request. Defaults to false.
+     * @returns A promise that resolves to the fetched {@link Emoji} object.
+     * @throws {Error} If the API request fails or if the emoji is detached.
+     * @example
+     * // Force fetch emoji to update its data
+     * await emoji.fetch(true);
+     */
+    fetch(force?: boolean): Promise<Emoji>;
+    /**
+     * Deletes this emoji from the server.
+     * @returns A promise that resolves when the emoji has been deleted.
+     * @throws {Error} If the API request fails or if the emoji is detached.
+     * @example
+     * // Delete an emoji from the server
+     * await emoji.delete();
+     */
+    delete(): Promise<void>;
+    /**
+     * Edits this emoji's properties.
+     * @param options The options to edit the emoji with.
+     * @returns A promise that resolves to the edited {@link Emoji} object.
+     * @throws {Error} If the API request fails or if the emoji is detached.
+     * @example
+     * // Edit an emoji's name
+     * await emoji.edit({ name: "new_name" });
+     */
+    edit(options: EmojiEditOptions): Promise<Emoji>;
 }
 
+interface EmojiCreateOptions {
+    emoji: string | AttachmentBuilder;
+    name: string;
+    nsfw?: boolean;
+}
+interface EmojiEditOptions {
+    name: string;
+}
+type EmojiResolvable = string | Emoji;
 declare class EmojiManager extends BaseManager<string, Emoji> {
     server?: Server | undefined;
     constructor(client: Client, server?: Server | undefined, limit?: number);
     /**
      * Tell BaseManager how to find the ID for Emojis
      */
-    protected extractId(data: any): string;
+    protected extractId(data: Emoji$1): string;
     /**
      * Tell BaseManager how to build an Emoji
      */
-    protected construct(data: any): Emoji;
-    fetch(id: string): Promise<Emoji>;
+    protected construct(data: Emoji$1): Emoji;
+    /**
+     * Fetch an Emoji from the API or resolves it from the local cache.
+     * @param emoji The ID, mention, or {@link Emoji} object to fetch
+     * @param force Whether to skip the cache check and force a direct API request. Defaults to false.
+     * @returns A promise that resolves to the fetched {@link Emoji} object.
+     * @throws {TypeError} If an invalid {@link EmojiResolvable} is provided.
+     * @throws {Error} If the API request fails.
+     * @example
+     * // Fetch a channel, bypassing cache
+     * const channel = await client.channels.fetch("01H...", true);
+     */
+    fetch(emoji: EmojiResolvable, force?: boolean): Promise<Emoji>;
+    /**
+     * Resolves a {@link EmojiResolvable} to a {@link Emoji} object from the cache.
+     * @param emoji The {@link EmojiResolvable} to resolve.
+     * @returns The resolved {@link Emoji} object, or undefined if not found.
+     */
+    resolve(emoji: EmojiResolvable): Emoji | undefined;
+    /**
+     * Extracts ID from a {@link EmojiResolvable}.
+     * @param emoji The {@link EmojiResolvable} to extract the ID from.
+     * @returns The extracted {@link Emoji} ID.
+     * @throws {TypeError} If an invalid type is provided.
+     */
+    resolveId(emoji: EmojiResolvable): string;
+    /**
+     * Create a new emoji
+     * @param options The options for creating the emoji
+     * @returns A promise that resolves to the created {@link Emoji} object.
+     * @throws {Error} If no server is registered in the {@link EmojiManager} or if the emoji attachment cannot be resolved.
+     * @example
+     * const emoji = await client.emojis.create(server, { emoji: "path/to/emoji.png", name: "myEmoji" });
+     */
+    crate(options: EmojiCreateOptions): Promise<Emoji>;
+    /**
+     * Delete an emoji
+     * @param emoji The {@link EmojiResolvable} to delete
+     * @throws {Error} If no server is registered in the {@link EmojiManager}.
+     * @example
+     * await client.emojis.delete(emoji);
+     */
+    delete(emoji: EmojiResolvable): Promise<void>;
+    /**
+     * Edit an emoji
+     * @param emoji The {@link EmojiResolvable} to edit
+     * @param options The options to edit the emoji with
+     * @returns A promise that resolves to the edited {@link Emoji} object.
+     * @throws {Error} If no server is registered in the {@link EmojiManager}.
+     * @example
+     * const editedEmoji = await client.emojis.edit(emoji, { name: "newName" });
+     */
+    edit(emoji: EmojiResolvable, options: EmojiEditOptions): Promise<Emoji>;
     [util.inspect.custom](): Collection<string, Emoji>;
 }
 
@@ -2131,9 +2225,13 @@ interface ClientOptions {
         channels?: number;
         emojis?: number;
     };
+    apiURL?: string;
+    overrides?: {
+        wsURL?: string;
+        cdnURL?: string;
+    };
 }
 declare class Client extends EventEmitter {
-    options: ClientOptions;
     rest: RESTManager;
     gateway: GatewayManager;
     channels: ChannelManager;
@@ -2142,11 +2240,13 @@ declare class Client extends EventEmitter {
     sweepers: SweeperManager;
     emojis: EmojiManager;
     user: ClientUser | null;
+    options: ClientOptions;
     constructor(options?: ClientOptions);
     /**
      * Connects the bot to the Stoat Gateway
      */
     login(token: string): Promise<any>;
+    private fetchConfig;
     on<K extends keyof ClientEvents>(event: K, listener: (...args: ClientEvents[K]) => void): this;
     once<K extends keyof ClientEvents>(event: K, listener: (...args: ClientEvents[K]) => void): this;
     emit<K extends keyof ClientEvents>(event: K, ...args: ClientEvents[K]): boolean;
@@ -2159,4 +2259,4 @@ declare class UnknownChannel extends BaseChannel {
     constructor(client: Client, data: Channel);
 }
 
-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, GroupChannel, 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 RawGroupChannel, 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 };
+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, type EmojiCreateOptions, type EmojiEditOptions, EmojiManager, type EmojiParent, type EmojiResolvable, type FetchMembersOptions, GatewayManager, GroupChannel, 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 RawGroupChannel, 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 };

package/dist/index.js

@@ -756,6 +756,7 @@ var GatewayManager = class {
     this.client = client;
   }
   ws = null;
+  wsURL = "";
   pingInterval = null;
   token = null;
   reconnectAttempts = 0;
@@ -770,7 +771,7 @@ var GatewayManager = class {
       this.ws.removeAllListeners();
       this.ws = null;
     }
-    const baseUrl = "wss://stoat.chat/events";
+    const baseUrl = this.wsURL ?? "wss://events.stoat.chat";
     const url = `${baseUrl}?version=1&format=json&token=${this.token}`;
     this.ws = new WebSocket(url);
     this.ws.on("open", () => {
@@ -790,6 +791,9 @@ var GatewayManager = class {
       this.client.emit("error", error);
     });
   }
+  setGatewayUrl(url) {
+    this.wsURL = url;
+  }
   handleMessage(rawData) {
     const payload = JSON.parse(rawData.toString());
     const eventType = payload.type;
@@ -1286,12 +1290,19 @@ var RESTManager = class {
       }
     }, 3e5).unref();
   }
-  baseURL = "https://stoat.chat/api";
+  baseURL = "";
+  cdnURL = "";
   token = null;
   buckets = /* @__PURE__ */ new Map();
   setToken(token) {
     this.token = token;
   }
+  setBaseURL(baseURL) {
+    this.baseURL = baseURL.replace(/\/+$/, "");
+  }
+  setCDNURL(cdnURL) {
+    this.cdnURL = cdnURL.replace(/\/+$/, "");
+  }
   /**
    * Generates a local identifier for the bucket based on method and path.
    */
@@ -1383,7 +1394,7 @@ var RESTManager = class {
    */
   async uploadFile(tag, fileBuffer, filename) {
     if (!this.token) throw new Error("REST_NOT_READY: No token available.");
-    const url = `https://cdn.stoatusercontent.com/${tag}`;
+    const url = `${this.cdnURL}/${tag}`;
     const formData = new FormData();
     formData.append("file", new Blob([fileBuffer]), filename);
     const response = await fetch(url, {
@@ -3779,6 +3790,50 @@ var Emoji = class extends Base {
     if (data.animated !== void 0) this.animated = data.animated;
     if (data.nsfw !== void 0) this.nsfw = data.nsfw;
   }
+  /**
+   * Fetch this emoji from the API or resolves it from the local cache.
+   * @param force Whether to skip the cache check and force a direct API request. Defaults to false.
+   * @returns A promise that resolves to the fetched {@link Emoji} object.
+   * @throws {Error} If the API request fails or if the emoji is detached.
+   * @example
+   * // Force fetch emoji to update its data
+   * await emoji.fetch(true);
+   */
+  async fetch(force) {
+    const server = this.client.servers.cache.get(this.parent.type === "Server" ? this.parent.id : "");
+    if (!server) throw new Error("No server registered in EmojiManager");
+    if (this.parent.type === "Detached") throw new Error("Cannot fetch a detached emoji");
+    return await server.emojis.fetch(this, force);
+  }
+  /**
+   * Deletes this emoji from the server.
+   * @returns A promise that resolves when the emoji has been deleted.
+   * @throws {Error} If the API request fails or if the emoji is detached.
+   * @example
+   * // Delete an emoji from the server
+   * await emoji.delete();
+   */
+  async delete() {
+    const server = this.client.servers.cache.get(this.parent.type === "Server" ? this.parent.id : "");
+    if (!server) throw new Error("No server registered in EmojiManager");
+    if (this.parent.type === "Detached") throw new Error("Emoji is already detached");
+    await server.emojis.delete(this);
+  }
+  /**
+   * Edits this emoji's properties.
+   * @param options The options to edit the emoji with.
+   * @returns A promise that resolves to the edited {@link Emoji} object.
+   * @throws {Error} If the API request fails or if the emoji is detached.
+   * @example
+   * // Edit an emoji's name
+   * await emoji.edit({ name: "new_name" });
+   */
+  async edit(options) {
+    const server = this.client.servers.cache.get(this.parent.type === "Server" ? this.parent.id : "");
+    if (!server) throw new Error("No server registered in EmojiManager");
+    if (this.parent.type === "Detached") throw new Error("Cannot edit a detached emoji");
+    return await server.emojis.edit(this, options);
+  }
 };
 
 // src/managers/EmojiManager.ts
@@ -3792,7 +3847,7 @@ var EmojiManager = class extends BaseManager {
    * Tell BaseManager how to find the ID for Emojis
    */
   extractId(data) {
-    return data._id ?? data.id;
+    return data._id;
   }
   /**
    * Tell BaseManager how to build an Emoji
@@ -3800,10 +3855,104 @@ var EmojiManager = class extends BaseManager {
   construct(data) {
     return new Emoji(this.client, data);
   }
-  async fetch(id) {
+  /**
+   * Fetch an Emoji from the API or resolves it from the local cache.
+   * @param emoji The ID, mention, or {@link Emoji} object to fetch
+   * @param force Whether to skip the cache check and force a direct API request. Defaults to false.
+   * @returns A promise that resolves to the fetched {@link Emoji} object.
+   * @throws {TypeError} If an invalid {@link EmojiResolvable} is provided.
+   * @throws {Error} If the API request fails.
+   * @example
+   * // Fetch a channel, bypassing cache
+   * const channel = await client.channels.fetch("01H...", true);
+   */
+  async fetch(emoji, force = false) {
+    if (!force) {
+      const cached = this.resolve(emoji);
+      if (cached) return cached;
+    }
+    const id = this.resolveId(emoji);
     const data = await this.client.rest.get(`/custom/emoji/${id}`);
     return this._add(data);
   }
+  /**
+   * Resolves a {@link EmojiResolvable} to a {@link Emoji} object from the cache.
+   * @param emoji The {@link EmojiResolvable} to resolve.
+   * @returns The resolved {@link Emoji} object, or undefined if not found.
+   */
+  resolve(emoji) {
+    if (emoji instanceof Emoji) return emoji;
+    if (typeof emoji === "string") {
+      const id = emoji.replace(/[<:>]/g, "");
+      return this.cache.get(id);
+    }
+    return void 0;
+  }
+  /**
+   * Extracts ID from a {@link EmojiResolvable}.
+   * @param emoji The {@link EmojiResolvable} to extract the ID from.
+   * @returns The extracted {@link Emoji} ID.
+   * @throws {TypeError} If an invalid type is provided.
+   */
+  resolveId(emoji) {
+    if (emoji instanceof Emoji) return emoji.id;
+    if (typeof emoji === "string") {
+      return emoji.replace(/:/g, "");
+    }
+    throw new Error("Invalid EmojiResolvable");
+  }
+  /**
+   * Create a new emoji
+   * @param options The options for creating the emoji
+   * @returns A promise that resolves to the created {@link Emoji} object.
+   * @throws {Error} If no server is registered in the {@link EmojiManager} or if the emoji attachment cannot be resolved.
+   * @example
+   * const emoji = await client.emojis.create(server, { emoji: "path/to/emoji.png", name: "myEmoji" });
+   */
+  async crate(options) {
+    if (!this.server) throw new Error("No server registered in EmojiManager");
+    const resolvedId = await resolveAttachment(this.client.rest, options.emoji, "emojis");
+    if (!resolvedId) throw new Error("Failed to resolve emoji attachment");
+    const payload = {
+      name: options.name,
+      parent: {
+        type: "Server",
+        id: this.server.id
+      }
+    };
+    if (options.nsfw) payload.nsfw = options.nsfw;
+    const data = await this.client.rest.put(`/custom/emoji/${resolvedId}`, payload);
+    return this._add(data);
+  }
+  /**
+   * Delete an emoji
+   * @param emoji The {@link EmojiResolvable} to delete
+   * @throws {Error} If no server is registered in the {@link EmojiManager}.
+   * @example
+   * await client.emojis.delete(emoji);
+   */
+  async delete(emoji) {
+    const id = this.resolveId(emoji);
+    await this.client.rest.delete(`/custom/emoji/${id}`);
+    this.cache.delete(id);
+  }
+  /**
+   * Edit an emoji
+   * @param emoji The {@link EmojiResolvable} to edit
+   * @param options The options to edit the emoji with
+   * @returns A promise that resolves to the edited {@link Emoji} object.
+   * @throws {Error} If no server is registered in the {@link EmojiManager}.
+   * @example
+   * const editedEmoji = await client.emojis.edit(emoji, { name: "newName" });
+   */
+  async edit(emoji, options) {
+    const id = this.resolveId(emoji);
+    const payload = {
+      name: options.name
+    };
+    const data = await this.client.rest.patch(`/custom/emoji/${id}`, payload);
+    return this._add(data);
+  }
   [util11.inspect.custom]() {
     return this.cache;
   }
@@ -4209,6 +4358,15 @@ var SweeperManager = class {
 
 // src/client/Client.ts
 var Client = class extends EventEmitter2 {
+  rest;
+  gateway;
+  channels;
+  servers;
+  users;
+  sweepers;
+  emojis;
+  user = null;
+  options;
   constructor(options = {}) {
     super({ captureRejections: true });
     this.options = options;
@@ -4220,23 +4378,40 @@ var Client = class extends EventEmitter2 {
     this.emojis = new EmojiManager(this, void 0, options.cacheLimits?.emojis);
     this.sweepers = new SweeperManager(this, options.sweepers ?? {});
   }
-  rest;
-  gateway;
-  channels;
-  servers;
-  users;
-  sweepers;
-  emojis;
-  user = null;
   /**
    * Connects the bot to the Stoat Gateway
    */
   async login(token) {
     if (!token) throw new Error("A valid token must be provided.");
-    this.sweepers.start();
+    const rootApiUrl = this.options.apiURL ?? "https://api.stoat.chat";
+    this.rest.setBaseURL(rootApiUrl);
     this.rest.setToken(token);
+    const configData = await this.fetchConfig(rootApiUrl);
+    const finalWsUrl = this.options.overrides?.wsURL ?? configData.ws;
+    if (!finalWsUrl) {
+      throw new Error(
+        `[Stoat Misconfiguration] The server at '${rootApiUrl}' is running, but it has no WebSocket URL configured. The server administrator needs to set their gateway config, or you must bypass it using 'options.overrides.wsURL'.`
+      );
+    }
+    this.gateway.setGatewayUrl(finalWsUrl);
+    const finalCdnUrl = this.options.overrides?.cdnURL ?? configData.features.autumn.url;
+    if (!finalCdnUrl) {
+      throw new Error(
+        `[Stoat Misconfiguration] The server at '${rootApiUrl}' is running, but it has no CDN URL configured. The server administrator needs to set their cdn config, or you must bypass it using 'options.overrides.cdnURL'.`
+      );
+    }
+    this.rest.setCDNURL(finalCdnUrl);
+    this.sweepers.start();
     return this.gateway.connect(token);
   }
+  async fetchConfig(baseURL) {
+    try {
+      const response = await fetch(baseURL);
+      return await response.json();
+    } catch (error) {
+      throw new Error(`Failed to fetch ${baseURL}, make sure the instance is running.`);
+    }
+  }
   [/* @__PURE__ */ Symbol.for("nodejs.rejection")](error) {
     this.emit("error", error);
   }