discord-self-lite 0.1.9 → 0.1.10

package/README.md

@@ -45,126 +45,17 @@ client.on("messageCreate", async (message) => {
 
 ## API Reference
 
-### Client
+The full API documentation is available in the [`docs/api/`](docs/api/README.md) directory. Here are the core classes:
 
-```javascript
-const { Client } = require("discord-self-lite");
-const client = new Client();
-```
-
-#### Methods
-
-- `client.login(token)` - Login with user token
-- `client.getChannel(channelId)` - Get cached channel
-- `client.fetchChannel(channelId)` - Fetch channel from API
-- `client.fetchMessage(channelId, messageId)` - Fetch specific message
-
-#### Properties
-
-- `client.user` - Current user object (available after ready event)
-- `client.guilds` - Map of cached guild instances
-- `client.channels` - Map of cached channel instances
-- `client.sessionId` - Session ID from Discord
-
-#### Events
-
-- `ready` - Fired when client is ready
-- `messageCreate` - Fired when a message is created
-
-### User
-
-#### Methods
-
-- `user.setStatus(status)` - Set user status ('online', 'idle', 'dnd', 'invisible')
-- `user.setPresence(presence)` - Set full presence data
-- `user.setActivity(activity)` - Set user activity
-
-#### Properties
-
-- `user.id` - User ID
-- `user.username` - Username
-- `user.discriminator` - Discriminator (4-digit number)
-- `user.avatar` - Avatar hash
-
-### Message
-
-#### Methods
-
-- `message.reply(content, options)` - Reply to the message
-- `message.react(emoji)` - React to the message
-- `message.clickButton(identifier)` - Click a button on the message
-  - `identifier` can be:
-    - `null` or omitted: clicks first button
-    - `number`: clicks button at index (0-based)
-    - `string`: clicks button with custom ID
-
-#### Properties
-
-- `message.content` - Message content
-- `message.author` - Message author
-- `message.channel` - Message channel
-- `message.guild` - Message guild (null for DMs)
-- `message.components` - Message components (buttons, etc.)
-
-### Channel
-
-#### Methods
-
-- `channel.send(content, options)` - Send a message to the channel
-- `channel.fetchMessages(options)` - Fetch messages from the channel
-
-#### Properties
-
-- `channel.id` - Channel ID
-- `channel.name` - Channel name
-- `channel.type` - Channel type
-
-### Guild
-
-#### Methods
-
-- `guild.getChannels()` - Get cached channels for this guild
-- `guild.fetchChannels()` - Fetch all channels for this guild from API
-- `guild.getChannel(channelId)` - Get a specific channel from cache
-- `guild.fetchChannel(channelId)` - Fetch a specific channel from API
-
-#### Properties
-
-- `guild.id` - Guild ID
-- `guild.name` - Guild name
-- `guild.icon` - Guild icon hash
-- `guild.ownerId` - Guild owner ID
-
-### WebhookClient
-
-Send messages to Discord webhooks with support for embeds and more.
-
-```javascript
-const { WebhookClient } = require("discord-self-lite");
-const webhook = new WebhookClient("YOUR_WEBHOOK_URL", {
-  username: "My Bot",
-  avatarURL: "https://example.com/avatar.png",
-});
-```
-
-#### Constructor
-
-- `new WebhookClient(url, options)` - Create a webhook client
-  - `url` - Discord webhook URL
-  - `options.username` - Default username for messages
-  - `options.avatarURL` - Default avatar URL for messages
-
-#### Methods
-
-- `webhook.send(content, options)` - Send a message (supports text, embeds, and objects)
-- `webhook.edit(messageId, content, options)` - Edit a message
-- `webhook.delete(messageId)` - Delete a message
-- `webhook.fetchMessage(messageId)` - Fetch a message
-
-#### Static Methods
+- **[`Client`](docs/api/Client.md)** - Main entry point, connection manager, and cache storage.
+- **[`User`](docs/api/User.md) & [`ClientUser`](docs/api/ClientUser.md)** - Represents Discord users and the logged-in selfbot.
+- **[`Message`](docs/api/Message.md)** - Represents text messages, supports replying, reacting, and clicking buttons.
+- **[`Channel`](docs/api/Channel.md)** - Represents Text, DM, or Voice channels to fetch or send messages.
+- **[`Guild`](docs/api/Guild.md) & [`GuildMember`](docs/api/GuildMember.md)** - Represents Discord servers and their members.
+- **[`WebhookClient`](docs/api/WebhookClient.md)** - Standalone client to send requests via webhooks.
+- **[`Permissions`](docs/api/Permissions.md) & [`BitField`](docs/api/BitField.md)** - Utility classes for resolving and checking Discord permissions.
 
-- `WebhookClient.createEmbed(data)` - Create an embed object
-- `WebhookClient.parseURL(url)` - Parse webhook URL to get ID and token
+_Check the [Complete API Reference](docs/api/README.md) for full properties, methods, and examples of each._
 
 ## Examples
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "discord-self-lite",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "Lightweight Discord selfbot library",
   "keywords": [
     "discord",
@@ -32,8 +32,7 @@
     "test": "eslint . && prettier --check .",
     "format": "prettier --write .",
     "fix": "eslint . --fix && prettier --write .",
-    "docs": "echo \"📚 Documentation available at docs/README.md\"",
-    "docs:html": "jsdoc -c jsdoc.conf.json"
+    "docs": "echo \"📚 Documentation available at docs/README.md\""
   },
   "repository": {
     "type": "git",

package/src/classes/Client.js

@@ -99,39 +99,63 @@ class Client extends EventEmitter {
   }
 
   /**
-   * Get channel from cache, or create empty instance if not cached
+   * Get channel from cache
    * @param {string} id - The channel ID
-   * @returns {Channel} The channel instance
+   * @returns {Channel|null} The cached channel instance or null
    */
   getChannel(id) {
-    if (!this.channels.has(id)) {
-      this.channels.set(id, new Channel(this, this.rest, id));
-    }
-    return this.channels.get(id);
+    return this.channels.get(id) || null;
   }
 
   /**
-   * Get guild from cache, or create empty instance if not cached
+   * Resolve channel from cache or fetch from API
+   * @param {string} id - The channel ID
+   * @returns {Promise<Channel>} The resolved channel instance
+   */
+  async resolveChannel(id) {
+    const cached = this.getChannel(id);
+    if (cached) return cached;
+    return await this.fetchChannel(id);
+  }
+
+  /**
+   * Get guild from cache
    * @param {string} id - The guild ID
-   * @returns {Guild} The guild instance
+   * @returns {Guild|null} The cached guild instance or null
    */
   getGuild(id) {
-    if (!this.guilds.has(id)) {
-      this.guilds.set(id, new Guild(this, this.rest, id));
-    }
-    return this.guilds.get(id);
+    return this.guilds.get(id) || null;
+  }
+
+  /**
+   * Resolve guild from cache or fetch from API
+   * @param {string} id - The guild ID
+   * @returns {Promise<Guild>} The resolved guild instance
+   */
+  async resolveGuild(id) {
+    const cached = this.getGuild(id);
+    if (cached) return cached;
+    return await this.fetchGuild(id);
   }
 
   /**
-   * Get user from cache, or create lightweight instance if not cached
+   * Get user from cache
    * @param {string} id - The user ID
-   * @returns {User} The User instance
+   * @returns {User|null} The cached user instance or null
    */
   getUser(id) {
-    if (!this.users.has(id)) {
-      this.users.set(id, new User(this, { id }));
-    }
-    return this.users.get(id);
+    return this.users.get(id) || null;
+  }
+
+  /**
+   * Resolve user from cache or fetch from API
+   * @param {string} id - The user ID
+   * @returns {Promise<User>} The resolved user instance
+   */
+  async resolveUser(id) {
+    const cached = this.getUser(id);
+    if (cached) return cached;
+    return await this.fetchUser(id);
   }
 
   /**

package/src/classes/Guild.js

@@ -44,7 +44,7 @@ class Guild {
   /**
    * Get a channel from this guild (from cache)
    * @param {string} channelId - The channel ID
-   * @returns {Channel} The channel instance
+   * @returns {Channel|null} The cached channel instance or null
    */
   getChannel(channelId) {
     const channel = this.client.getChannel(channelId);

package/src/classes/Message.js

@@ -42,7 +42,7 @@ class Message {
 
   /**
    * Get the channel this message was sent in
-   * @returns {Channel} The channel instance
+   * @returns {Channel|null} The cached channel instance, or null if not cached
    */
   get channel() {
     return this.client.getChannel(this.channelId);
@@ -89,11 +89,12 @@ class Message {
    * @returns {Promise<object>} The sent reply message data
    */
   async reply(payload) {
+    const channel = await this.client.resolveChannel(this.channelId);
     const replyPayload =
       typeof payload === "string"
         ? { content: payload, message_reference: { message_id: this.id } }
         : { ...payload, message_reference: { message_id: this.id } };
-    return await this.channel.send(replyPayload);
+    return await channel.send(replyPayload);
   }
 
   /**
@@ -203,14 +204,11 @@ class Message {
     const channelId = ref.channelId || ref.channel_id || this.channelId;
     if (!messageId || !channelId) return null;
 
-    // Try to get channel from cache or fetch from API
-    let channel = this.client.getChannel(channelId);
-    if (!channel) {
-      try {
-        channel = await this.client.fetchChannel(channelId);
-      } catch {
-        return null;
-      }
+    let channel;
+    try {
+      channel = await this.client.resolveChannel(channelId);
+    } catch {
+      return null;
     }
 
     try {