revbot.js 0.1.8 → 0.1.10

package/dist/index.d.ts

@@ -72,6 +72,9 @@ declare class UUID extends null {
     static timestampOf(id: string): Date;
 }
 
+/** A type that can be a BitField, number, string, or an array of these types.
+ * @private
+ */
 type BitFieldResolvable = BitField | number | string | BitFieldResolvable[];
 /**
  * Represents a bitfield that can be used to manage flags or permissions.
@@ -194,7 +197,6 @@ declare class CDNClient {
      * POST request.
      * @param url The URL for the request.
      * @param data The request body.
-     * @param query Query parameters (if applicable).
      * @returns The API response.
      */
     post<T>(url: string, data: FormData): Promise<T>;
@@ -356,6 +358,7 @@ declare abstract class BaseClient extends EventEmitter {
 
 /**
  * Enum representing the client events that can be emitted.
+ * @private
  */
 declare enum Events {
     CHANNEL_CREATE = "channelCreate",
@@ -388,6 +391,7 @@ declare enum Events {
 }
 /**
  * Enum representing the WebSocket events used for communication.
+ * @private
  */
 declare enum WSEvents {
     AUTHENTICATE = "Authenticate",
@@ -1669,9 +1673,14 @@ declare class NotesChannel extends Channel implements TextBasedChannel {
     get user(): User;
 }
 
-type APIServerChannel$1 = Extract<Channel$1, {
+/**
+ * Represents a channel in the API.
+ * @private
+ */
+type APIServerChannel = Extract<Channel$1, {
     channel_type: "TextChannel" | "VoiceChannel";
 }>;
+
 interface Overwrite {
     allow: FullPermissions;
     deny: FullPermissions;
@@ -1690,6 +1699,8 @@ declare class ServerChannel extends Channel {
     description: string | null;
     /** The icon of the channel, or `null` if none is set. */
     icon: Attachment | null;
+    /** Manages the messages in this Server channel. */
+    messages: MessageManager;
     /** The permission overwrites for the channel. */
     overwrites: Map<string, Overwrite>;
     /** Whether the channel is marked as NSFW (Not Safe For Work). */
@@ -1700,7 +1711,7 @@ declare class ServerChannel extends Channel {
      * @param {client} client - The client instance.
      * @param {APIServerChannel} data - The raw data for the server channel from the API.
      */
-    constructor(client: client, data: APIServerChannel$1);
+    constructor(client: client, data: APIServerChannel);
     /**
      * Updates the server channel instance with new data from the API.
      *
@@ -1709,7 +1720,7 @@ declare class ServerChannel extends Channel {
      * @returns {this} The updated server channel instance.
      * @protected
      */
-    protected _patch(data: APIServerChannel$1, clear?: FieldsChannel[]): this;
+    protected _patch(data: APIServerChannel, clear?: FieldsChannel[]): this;
     /**
      * Creates an invite for the server channel.
      *
@@ -1728,6 +1739,18 @@ declare class ServerChannel extends Channel {
      * @returns {Server} The server instance.
      */
     get server(): Server;
+    /**
+     * Sends a message to this Server channel.
+     *
+     * @param {MessageOptions | string} options - The message content or options for the message.
+     * @returns {Promise<Message>} A promise that resolves with the sent message.
+     *
+     * @example
+     * ```typescript
+     * await serverChannel.send("Hello, world!");
+     * ```
+     */
+    send(options: MessageOptions | string): Promise<MessageStruct>;
     /**
      * Retrieves the category this channel belongs to, if any.
      *
@@ -2033,6 +2056,7 @@ declare class Emoji extends Base {
 
 type UserResolvable = User | User$1 | MessageStruct | string;
 declare class UserManager extends BaseManager<User, User$1> {
+    /** @private */
     holds: typeof User;
     /**
      *
@@ -2081,10 +2105,12 @@ declare class ClientUser extends User {
      * ```
      */
     setUsername(username: string, password?: string): Promise<void>;
+    setStatus(text?: string | null): Promise<void>;
+    setStatus(presence?: Status): Promise<void>;
     /**
      * Updates the status of the client user.
      *
-     * @param {string | null} text - The status text to set, or `null` to clear the status.
+     * @param {string | null} [text] - The status text to set, or `null` to clear the status.
      * @param {Status} [presence] - The presence status (e.g., online, idle, etc.).
      * @returns {Promise<void>} A promise that resolves when the status has been successfully updated.
      *
@@ -2093,14 +2119,13 @@ declare class ClientUser extends User {
      * await clientUser.setStatus("Available", "Online");
      * ```
      */
-    setStatus(text?: string | null): Promise<void>;
-    setStatus(presence?: Status): Promise<void>;
     setStatus(text?: string | null, presence?: keyof typeof Status): Promise<void>;
 }
 
 /**
  * Represents the base class for all event handlers.
  * All event handlers must extend this class and implement the `handle` method.
+ *  @private
  */
 declare abstract class Event {
     protected readonly client: client;
@@ -2122,6 +2147,8 @@ declare abstract class Event {
 
 /**
  * Manages the registration and retrieval of events for the client.
+ * @private
+ * @extends Event
  */
 declare class EventManager {
     #private;
@@ -2332,14 +2359,18 @@ declare abstract class BaseManager<Holds extends {
     readonly cache: Map<string, Holds>;
     /** Instance level max size (can be changed per manager instance). */
     protected maxSize: number;
+    /** @private */
     Holds: any;
     constructor(client: client, maxSize?: number);
     /**
      * Adds a raw object to the cache, constructing the holdable class.
      * Automatically evicts oldest entries if the max size is exceeded.
+     * @private
      */
     _add(raw: R): Holds;
-    /** Remove an entry by id. */
+    /** Remove an entry by id.
+     * @private
+     */
     _remove(id: string): void;
     /** Adjust the maximum size for this manager at runtime. */
     setMaxSize(size: number): void;
@@ -2355,7 +2386,9 @@ declare abstract class BaseManager<Holds extends {
 
 type ChannelResolvable = Channel | Channel$1 | string;
 declare class ChannelManager extends BaseManager<Channel, Channel$1> {
+    /** @private */
     holds: null;
+    /** @private */
     _add(data: Channel$1): Channel;
     _remove(id: string): void;
     /**
@@ -2395,7 +2428,9 @@ interface EditServerOptions {
     description?: string;
 }
 declare class ServerManager extends BaseManager<Server, Server$1> {
+    /** @private */
     readonly holds: typeof Server;
+    /** @private */
     _remove(id: string): void;
     /**
      * edits a server
@@ -2449,6 +2484,7 @@ interface MessageQueryOptions {
 }
 declare class MessageManager extends BaseManager<MessageStruct, Message> {
     protected readonly channel: Channel;
+    /** @private */
     holds: typeof MessageStruct;
     constructor(channel: Channel, maxSize?: number);
     /**
@@ -2540,8 +2576,10 @@ declare class RoleManager extends BaseManager<Role, Role$1 & {
     id: string;
 }> {
     protected readonly server: Server;
+    /** @private */
     holds: typeof Role;
     constructor(server: Server);
+    /** @private */
     _add(data: Role$1 & {
         id: string;
     }): Role;
@@ -2573,9 +2611,6 @@ declare class RoleManager extends BaseManager<Role, Role$1 & {
     edit(role: RoleResolvable, data: editableRole): Promise<Role>;
 }
 
-type APIServerChannel = Extract<Channel$1, {
-    channel_type: "TextChannel" | "VoiceChannel";
-}>;
 type ServerChannelResolvable = ServerChannel | APIServerChannel | string;
 interface CreateChannelOptions {
     name: string;
@@ -2584,15 +2619,18 @@ interface CreateChannelOptions {
 }
 declare class ServerChannelManager extends BaseManager<ServerChannel> {
     protected readonly server: Server;
+    /** @private */
     holds: typeof ServerChannel;
     constructor(server: Server);
+    /** @private */
     _add(data: APIServerChannel): ServerChannel;
     /**
-     * creates a new channel in the server
-     * @param name The name of the channel to create
-     * @param type The type of the channel to create. Can be "Text" or "Voice". Defaults to "Text".
-     * @param description The description of the channel to create. Only used for voice channels.
-     * @returns A promise that resolves to the created channel
+     * Creates a new channel in the server.
+     * @param options - Options for creating the channel.
+     * @param options.name - The name of the channel to create.
+     * @param [options.type="Text"] - The type of the channel to create. Can be "Text" or "Voice". Defaults to "Text".
+     * @param [options.description] - The description of the channel to create. Only used for voice channels.
+     * @returns A promise that resolves to the created channel.
      */
     create({ name, type, description, }: CreateChannelOptions): Promise<ServerChannel>;
     /**
@@ -2615,6 +2653,7 @@ interface EditServerMemberOptions {
 }
 declare class ServerMemberManager extends BaseManager<ServerMember, Member> {
     protected readonly server: Server;
+    /** @private */
     holds: typeof ServerMember;
     constructor(server: Server);
     /**
@@ -2661,4 +2700,4 @@ declare class ServerMemberManager extends BaseManager<ServerMember, Member> {
     resolveId(member: ServerMemberResolvable): string | null;
 }
 
-export { Attachment, type BadgeString, Badges, type BadgesResolvable, Base, BaseManager, BitField, type BitFieldResolvable, Category, Channel, ChannelManager, ChannelPermissions, type ChannelPermissionsResolvable, type ChannelPermissionsString, type ChannelResolvable, ChannelTypes, type CreateChannelOptions, DEFAULT_CLIENT_OPTIONS, DEFAULT_PERMISSION_DM, DMChannel, type EditServerMemberOptions, type EditServerOptions, type Embed, type EmbedImage, type EmbedSpecial, type EmbedVideo, Emoji, Events, FullPermissions, GroupChannel, Invite, Mentions, type MessageEditOptions, MessageEmbed, MessageManager, type MessageOptions, type MessageQueryOptions, type MessageReply, type MessageResolvable, type MessageSearchOptions, MessageStruct, NotesChannel, type Overwrite, Presence, Role, RoleManager, type RoleResolvable, SYSTEM_USER_ID, Server, ServerChannel, ServerChannelManager, type ServerChannelResolvable, ServerManager, ServerMember, ServerMemberManager, type ServerMemberResolvable, ServerPermissions, type ServerPermissionsResolvable, type ServerPermissionsString, type ServerResolvable, Status, TextChannel, UUID, User, UserManager, UserPermissions, type UserPermissionsResolvable, type UserPermissionsString, type UserResolvable, VoiceChannel, WSEvents, apiUrl, cdnUrl, client, wsUrl };
+export { Attachment, type BadgeString, Badges, type BadgesResolvable, Base, BaseManager, BitField, type BitFieldResolvable, Category, Channel, ChannelManager, ChannelPermissions, type ChannelPermissionsResolvable, type ChannelPermissionsString, type ChannelResolvable, ChannelTypes, type CreateChannelOptions, DEFAULT_CLIENT_OPTIONS, DEFAULT_PERMISSION_DM, DMChannel, type EditServerMemberOptions, type EditServerOptions, type Embed, type EmbedImage, type EmbedSpecial, type EmbedVideo, Emoji, Events, FullPermissions, GroupChannel, Invite, Mentions, type MessageEditOptions, MessageEmbed, MessageManager, type MessageOptions, type MessageQueryOptions, type MessageReply, type MessageResolvable, type MessageSearchOptions, MessageStruct, NotesChannel, type Overwrite, type PartialObject, Presence, Role, RoleManager, type RoleResolvable, SYSTEM_USER_ID, Server, ServerChannel, ServerChannelManager, type ServerChannelResolvable, ServerManager, ServerMember, ServerMemberManager, type ServerMemberResolvable, ServerPermissions, type ServerPermissionsResolvable, type ServerPermissionsString, type ServerResolvable, Status, TextChannel, UUID, User, UserManager, UserPermissions, type UserPermissionsResolvable, type UserPermissionsString, type UserResolvable, VoiceChannel, WSEvents, apiUrl, cdnUrl, client, wsUrl };

package/dist/index.js

@@ -168,6 +168,7 @@ var _BaseManager = class _BaseManager {
   /**
    * Adds a raw object to the cache, constructing the holdable class.
    * Automatically evicts oldest entries if the max size is exceeded.
+   * @private
    */
   _add(raw) {
     if (!this.holds) throw new Error("Holds is not defined");
@@ -176,7 +177,9 @@ var _BaseManager = class _BaseManager {
     this.enforceMaxSize();
     return obj;
   }
-  /** Remove an entry by id. */
+  /** Remove an entry by id.
+   * @private
+   */
   _remove(id) {
     this.cache.delete(id);
   }
@@ -2098,6 +2101,8 @@ var ServerChannel = class extends Channel {
     this.description = null;
     /** The icon of the channel, or `null` if none is set. */
     this.icon = null;
+    /** Manages the messages in this Server channel. */
+    this.messages = new MessageManager(this);
     /** The permission overwrites for the channel. */
     this.overwrites = /* @__PURE__ */ new Map();
     /** Whether the channel is marked as NSFW (Not Safe For Work). */
@@ -2168,6 +2173,20 @@ var ServerChannel = class extends Channel {
   get server() {
     return this.client.servers.cache.get(this.serverId);
   }
+  /**
+   * Sends a message to this Server channel.
+   *
+   * @param {MessageOptions | string} options - The message content or options for the message.
+   * @returns {Promise<Message>} A promise that resolves with the sent message.
+   *
+   * @example
+   * ```typescript
+   * await serverChannel.send("Hello, world!");
+   * ```
+   */
+  send(options) {
+    return this.messages.send(options);
+  }
   /**
    * Retrieves the category this channel belongs to, if any.
    *
@@ -2578,8 +2597,10 @@ var Emoji2 = class extends Base {
 var ChannelManager = class extends BaseManager {
   constructor() {
     super(...arguments);
+    /** @private */
     this.holds = null;
   }
+  /** @private */
   _add(data) {
     let channel;
     switch (data.channel_type) {
@@ -2673,8 +2694,10 @@ var ChannelManager = class extends BaseManager {
 var ServerManager = class extends BaseManager {
   constructor() {
     super(...arguments);
+    /** @private */
     this.holds = Server2;
   }
+  /** @private */
   _remove(id) {
     var _a;
     const server = this.cache.get(id);
@@ -2727,6 +2750,7 @@ var ServerManager = class extends BaseManager {
 var UserManager = class extends BaseManager {
   constructor() {
     super(...arguments);
+    /** @private */
     this.holds = User;
   }
   /**
@@ -2770,6 +2794,7 @@ var MessageManager = class extends BaseManager {
   constructor(channel, maxSize = 1e3) {
     super(channel.client, maxSize);
     this.channel = channel;
+    /** @private */
     this.holds = MessageStruct;
   }
   /**
@@ -3013,8 +3038,10 @@ var RoleManager = class extends BaseManager {
   constructor(server) {
     super(server.client);
     this.server = server;
+    /** @private */
     this.holds = Role;
   }
+  /** @private */
   _add(data) {
     const role = new Role(this.server, data);
     this.cache.set(role.id, role);
@@ -3086,8 +3113,10 @@ var ServerChannelManager = class extends BaseManager {
   constructor(server) {
     super(server.client);
     this.server = server;
+    /** @private */
     this.holds = ServerChannel;
   }
+  /** @private */
   _add(data) {
     let channel;
     switch (data.channel_type) {
@@ -3106,11 +3135,12 @@ var ServerChannelManager = class extends BaseManager {
     return channel;
   }
   /**
-   * creates a new channel in the server
-   * @param name The name of the channel to create
-   * @param type The type of the channel to create. Can be "Text" or "Voice". Defaults to "Text".
-   * @param description The description of the channel to create. Only used for voice channels.
-   * @returns A promise that resolves to the created channel
+   * Creates a new channel in the server.
+   * @param options - Options for creating the channel.
+   * @param options.name - The name of the channel to create.
+   * @param [options.type="Text"] - The type of the channel to create. Can be "Text" or "Voice". Defaults to "Text".
+   * @param [options.description] - The description of the channel to create. Only used for voice channels.
+   * @returns A promise that resolves to the created channel.
    */
   create(_0) {
     return __async(this, arguments, function* ({
@@ -3162,6 +3192,7 @@ var ServerMemberManager = class extends BaseManager {
   constructor(server) {
     super(server.client);
     this.server = server;
+    /** @private */
     this.holds = ServerMember3;
   }
   /**
@@ -3277,7 +3308,7 @@ var import_node_events = require("events");
 var import_axios4 = require("axios");
 
 // package.json
-var version = "0.1.8";
+var version = "0.1.10";
 
 // src/rest/restUtils/rateLimitQueue.ts
 var import_axios3 = __toESM(require("axios"));
@@ -3375,7 +3406,7 @@ var RestClient = class {
    */
   request(method, url, body, query, retry) {
     return __async(this, null, function* () {
-      var _a, _b, _c;
+      var _a, _b, _c, _d, _e;
       try {
         if (!this.client.token) throw new Error("Token is required");
         const authHeader = this.client.bot ? "X-Bot-Token" : "X-Session-Token";
@@ -3389,7 +3420,7 @@ var RestClient = class {
             "User-Agent": `RevBot.js/${version}`
           }
         }), {
-          url: `${apiUrl}${url}`
+          url: `${((_c = this.client.options.rest) == null ? void 0 : _c.instanceURL) ? (_d = this.client.options.rest) == null ? void 0 : _d.instanceURL : apiUrl}${url}`
         });
         const response = yield this.rateLimitQueue.request(config);
         return response.data;
@@ -3401,7 +3432,7 @@ var RestClient = class {
           }
           if (error.status) {
             throw new Error(
-              `API call failed with status ${error.status}: ${(_c = error.response) == null ? void 0 : _c.statusText}`
+              `API call failed with status ${error.status}: ${(_e = error.response) == null ? void 0 : _e.statusText}`
             );
           }
         }
@@ -3577,7 +3608,6 @@ var CDNClient = class {
    * POST request.
    * @param url The URL for the request.
    * @param data The request body.
-   * @param query Query parameters (if applicable).
    * @returns The API response.
    */
   post(url, data) {
@@ -3677,6 +3707,7 @@ var ChannelCreate = class extends Event {
    *
    * @param {API.Channel} data - The raw data for the created channel from the API.
    * @returns {Promise<{ channel: unknown }>} A promise that resolves with the created channel.
+   * @private
    */
   handle(data) {
     return __async(this, null, function* () {
@@ -3817,6 +3848,7 @@ var Message = class extends Event {
    *
    * @param {API.Message} data - The raw data for the message from the API.
    * @returns {Promise<{ message: unknown }>} A promise that resolves with the created message, or an empty object if the channel is not text-based.
+   * @private
    */
   handle(data) {
     return __async(this, null, function* () {
@@ -3886,6 +3918,7 @@ var ServerCreate = class extends Event {
    *
    * @param {API.Server} data - The raw data for the created server from the API.
    * @returns {Promise<void>} A promise that resolves when the server is added and members are optionally fetched.
+   * @private
    */
   handle(data) {
     return __async(this, null, function* () {
@@ -4411,21 +4444,21 @@ var WebSocketClient = class {
               this.client.users._add(user);
             }
           }
-          for (const server of packet.servers) {
-            const s = this.client.servers._add(server);
-            if (this.client.options.fetchMembers) {
-              promises.push(s.members.fetch());
-            }
-          }
-          for (const channel of packet.channels) {
-            this.client.channels._add(channel);
-          }
           for (const member of packet.members) {
             (_a = this.client.servers.cache.get(member._id.server)) == null ? void 0 : _a.members._add(member);
           }
           for (const emoji of packet.emojis) {
             (_b = this.client.servers.cache.get(emoji.parent.id)) == null ? void 0 : _b.emojis.set(emoji._id, __spreadProps(__spreadValues({}, emoji), { _id: emoji._id }));
           }
+          for (const channel of packet.channels) {
+            this.client.channels._add(channel);
+          }
+          for (const server of packet.servers) {
+            const s = this.client.servers._add(server);
+            if (this.client.options.fetchMembers) {
+              promises.push(s.members.fetch());
+            }
+          }
           this.setHeartbeatTimer(
             (_d = (_c = this.client.options.ws) == null ? void 0 : _c.heartbeatInterval) != null ? _d : 3e4
           );