@imaentity/selfjs 2.9.11 → 3.1.0

package/README.md

@@ -1,7 +1,11 @@
 # SelfJS
-Install: `npm i @imaentity/selfjs`
+Install Command: `npm i @imaentity/selfjs`
 
-An example of an echo bot:
+## Documentation
+View Documentation [**Here**](https://github.com/ImaEntity/SelfJS/blob/master/docs.md)
+
+## Bot Example's
+Echo Bot:
 ```JS
 const discord = require("@imaentity/SelfJS");
 const client = new discord.Client();

package/changelog.log

@@ -1,5 +1,29 @@
 V2.9.11
     Added:
         changelog.log
+        
     Changed:
-        Client.setStatus now has default params
+        Client.setStatus now has default params
+
+V2.10.11
+    Added:
+        Docs link to README.md
+
+    Changed:
+        Structure of docs.md
+
+    Removed:
+        The default option in the status enum
+
+V3.0.0
+    Changed:
+        Overhaul to the structure of self.js
+
+V3.1.0
+    Added:
+        Webhooks can now send files
+        Client.getUserProfile to fetch user profiles
+        Client.createServer to create a server
+    
+    Changed:
+        Client.getUser now gets the actual user instead of their profile

package/docs.md

@@ -1,92 +1,471 @@
-# Properties
-- **status**: The enum that holds the different status types.
-
-# Functions
-- **sleep(millis)**: A promise-based sleep function that pauses execution for the given time in milliseconds.
-
-- **sendWebhookMessage(webhookID, webhookToken, inputData)**: A function to send a webhook message. The webhook token and ID are provided, along with any input data.
-
-- **jsonEncode(jsonObject)**: Encodes a JSON object for use with the discord API. (Self does this automatically.)
-
-# Class
-- **Client**: This class allows the interaction with the Discord server. The following are its methods:
-
-  - **userID**: The client's user ID.
+# 📜 Documentation
+Welcome To SelfJS Documentation
+
+> [!WARNING]
+> Doc's might not be Up-to-Date or 100% Correct.
+
+## Properties
++ ### ℹ Activites Status:
+  The enum that holds the different status types.
+
+  **Types:**
+  ```
+  Playing   : 0
+  Streaming : 1
+  Listening : 2
+  Watching  : 3
+  Custom    : 4
+  Competing : 5
+  ```
+
++ ### 🎮 Status:
+  The string that holds the different status types.
+
+  **Types:**
+  ```
+  "online",
+  "dnd",
+  "idle",
+  "invisible" 
+  ```
+
+## Functions
++ ### 😴 Sleep:
+  A promise-based sleep function that pauses execution for the given time in milliseconds.
+  > Paramaters:  Miliseconds (Int) 
   
-  - **token**: The client's token.
-
-  - **latency**: The latency of the client's websocket connection.
-
-  - **login(token, isMobile = false, logMsgs = false)**: Logs in the client to Discord.
-
-  - **onMessage(msgFunc)**: Function to be executed when a message is received.
-
-  - **onMessageEdit(editFunc)**: Function to be executed when a message is edited.
-
-  - **onStatusUpdate(statusFunc)**: Function to be executed when a status update occurs.
-
-  - **getDMChannel(userID)**: Gets the Direct Message (DM) channel for the specified user.
-
-  - **getRoles(serverID, userID)**: Gets the roles for a user in a server.
-
-  - **uploadFile(channelID, fileName, isSpoiled = false, msgContent = "", messageID = null)**: Uploads a file to the specified channel.
-
-  - **search(channelID, options)**: Search for messages in a channel based on the specified options.
-
-  - **getUserData(userID)**: Gets the data of a user.
-
-  - **setRolesForMember(serverID, userID, roleIDs)**: Sets roles for a member in a server.
-
-  - **sendMessage(channelID, message)**: Sends a message to a specified channel.
-
-  - **replyToMessage(channelID, messageID, message)**: Replies to a specified message.
-
-  - **createChannel(guildID, name, type, parentID = null)**: Creates a channel in a server based on the specified options.
-
-  - **setChannelPermissions(channelID, userID, allow, deny)**: Sets a users permissions in a channel based on the specified options.
-
-  - **getMessages(channelID, limit)**: Gets messages from a channel with a limit.
-
-  - **getUsers(guildID)**: Gets users from a guild.
-
-  - **removeFromChannel(channelID, userID)**: Removes a user from a channel.
-
-  - **leaveChannel(channelID)**: Leaves a channel.
-
-  - **ring(channelID, userIDs)**: Starts a call with the specified users in a channel.
-
-  - **stopRinging(channelID, userIDs)**: Stops ringing the specified users in a channel.
-
-  - **addToChannel(channelID, userID)**: Adds a user to a channel.
-
-  - **getAvatar(userID, size = 256)**: Gets the avatar of a user.
-
-  - **addFriend(userID)**: Sends a friend request to a user.
-
-  - **editMessage(channelID, messageID, newMessage)**: Edits a message.
-
-  - **removeFriend(userID)**: Removes a user from the friend list.
-
-  - **renameChannel(channelID, channelName)**: Renames a channel.
-
-  - **block(userID)**: Blocks a user.
-
-  - **unblock(userID)**: Unblocks a user.
-
-  - **deleteMessage(channelID, messageID)**: Deletes a message.
-
-  - **setStatus(status, activities, afk = false)**: Sets the status of the client.
-
-  - **createGroupChat(userIDs)**: Creates a new channel with the specified users.
-
-  - **startTyping(channelID)**: Simulates the client typing in a channel.
-
-  - **pinMessage(channelID, messageID)**: Pins a message in a channel.
-
-  - **unpinMessage(channelID, messageID)**: Unpins a message in a channel.
-
-  - **editNote(userID, note)**: Edits a note for a user.
-
-  - **getChannelData(channelID)**: Gets data of a channel.
-
-  - **transferOwnership(channelID, userID)**: Transfers ownership of a channel to another user.
+  <br>Example:
+  ```javascript 
+  self.sleep(1000);
+  ```
++ ### 🤖 Send Webhook Message:
+  A function to send a webhook message. The webhook token and ID are provided, along with any input data.
+  >Paramaters: webhookID (String), webhookToken (String or JSON), inputData (JSON)
+
+  <br>Example:
+  ```javascript
+  self.sendWebhookMessage("012345678910111213", "012345678910111213141516.123456.123456789101112131415161718", {
+    "content": "Sending Content Through Webhook"
+  });
+  ```
+  or
+  ```javascript
+  self.sendWebhookMessage("https://discord.com/api/webhooks/01234567891011121314/012345678910111213141516.123456.123456789101112131415161718", {
+    "content": "Sending Content Through Webhook"
+  });
+  ```
+
++ ### 📄 JSON Encode
+  Encodes a JSON object for use with the discord API. (Self does this automatically.)
+  >Paramaters: jsonObject (JSON)
+
+  <br>Example:
+  ```javascript
+  self.jsonEncode({content: "Hello, world!"});
+  ```
+
+## Class
++ ### Client
+  This class allows the interaction with the Discord server.
+
+  <br>Example:
+  ```javascript
+  const self = require("@imaentity/selfjs");
+  const client = new self.Client();
+  ```
+
+  + ### 🧑 UserID: The client's user ID.
+
+  + ### 🎟 Token: The client's token.
+
+  + ### 📶 Latency: The latency of the client's websocket connection.
+
+  + ### 🔑 Login (REQUIRED)
+    Logs in the client to Discord.
+    >Paramaters: Token (String), isMobile (Boolean | false), logMsgs (Boolean | false)
+
+    <br>Example:
+    ```javascript
+    client.login("012345678910111213141516.123456.123456789101112131415161718");
+    ```
+
+  + ### 💬 onMessage
+    Function to be executed when a message is received.
+    >Paramaters: msgFunc (Function)
+
+    <br>Example:
+    ```javascript
+    client.onMessage(async function(msg) {
+      console.log("Message Received: " + msg.content);
+    });
+    ```
+
+  + ### ✏ onMessageEdit
+    Function to be executed when a message is edited.
+    >Paramaters: editFunc (Function)
+
+    <br>Example:
+    ```javascript
+    client.onMessageEdit(async function(msg) {
+      console.log("Message Edited: " + msg.content);
+    });
+    ```
+
+  + ### 🚮 onMessageDelete
+    Function to be executed when a message is deleted.
+    Deleted message objects only receive the channel and message ids.
+    >Paramaters: deleteFunc (Function)
+
+    <br>Example:
+    ```javascript
+    client.onMessageDelete(async function(msg) {
+      console.log("Message Deleted: " + msg.id);
+    });
+    ```
+
+  + ### 🕶 onStatusUpdate
+    Function to be executed when a status update occurs.
+    >Paramaters: statusFunc (Function)
+
+    <br>Example:
+    ```javascript
+    client.onStatusUpdate(async function(status) {
+      console.log(status);
+    });
+    ```
+  
+  + ### 🔏 getDMChannel
+    Gets the Direct Message (DM) channel for the specified user.
+    >Paramaters: userID (String)
+
+    <br>Example:
+    ```javascript
+    client.getDMChannel("01234567891011121314");
+    ```
+
+  + ### 🧪 getRoles
+    Gets the roles for a user in a server.
+    >Paramaters: serverID (String), userID (String)
+
+    <br>Example:
+    ```javascript
+    client.getRoles("01234567891011121314", "41312111019876543210");
+    ```
+
+  + ### 📁 uploadFile
+    Uploads a file to the specified channel.
+    >Paramaters: channelID (String), fileName (String), isSpoiled (Boolean | false), msgContent (String | ""), messageID (String | null)
+
+    <br>Example:
+    ```javascript
+    client.uploadFile("01234567891011121314", "image.png", true, "Message Related to The Image", "41312111019876543210");
+    ```
+  
+  + ### 🔍 search
+    Search for messages in a channel based on the specified options.
+    >Paramaters: channelID (String), options (JSON)
+
+    <br>Example:
+    ```javascript
+    client.search("01234567891011121314", {
+      content: "Hello, world!"
+    });
+    ```
+
+  + ### 👤 getUserProfile
+    Gets the profile of a user.
+    >Paramaters: userID (String)
+
+    <br>Example:
+    ```javascript
+    client.getUserProfile("01234567891011121314");
+    ```
+
+  + ### 👤 getUserData
+    Gets the data of a user.
+    >Paramaters: userID (String)
+
+    <br>Example:
+    ```javascript
+    client.getUserData("01234567891011121314");
+    ```
+  
+  + ### 🔨 setRolesForMember
+    Sets roles for a member in a server.
+    >Paramaters: serverID (String), userID (String), roleIDs (Array)
+
+    <br>Example:
+    ```javascript
+    client.setRolesForMember("01234567891011121314", "41312111019876543210", [
+      "1285712985712985712",
+      "1284578912561872568",
+      "9127498127459812749"
+    ]);
+    ```
+
+  + ### 🗣 sendMessage
+    Sends a message to a specified channel.
+    >Paramaters: channelID (String), message (String)
+
+    <br>Example:
+    ```javascript
+    client.sendMessage("01234567891011121314", "Message");
+    ```
+  
+  + ### 👨🏻‍🤝‍👨🏻 replyToMessage
+    Replies to a specified message.
+    >Paramaters: channelID (String), messageID (String), message (String)
+
+    <br>Example:
+    ```javascript
+    client.replyToMessage("01234567891011121314", "41312111019876543210", "Replied Message");
+    ```
+
+  + ### 📔 createChannel
+    Creates a channel in a server based on the specified options.
+    >Paramaters: guildID (String), name (String), type (Int), parentID (String | null)
+
+    <br>Example:
+    ```javascript
+    // 0 = GUILD_TEXT
+
+    client.createChannel("01234567891011121314", "new-channel", 0, "41312111019876543210");
+    ```
+
+  + ### 👑 setChannelPermissons
+    Sets a users permissions in a channel based on the specified options.
+    >Paramaters: channelID (String), userID (String), allow (String | 0), deny (String | 0)
+
+    <br>Example:
+    ```javascript
+    client.setChannelPermissons("01234567891011121314", "41312111019876543210");
+    ```
+
+  + ### 📖 getMessages
+    Gets messages from a channel with a limit.
+    >Paramaters: channelID (String), limit (Int)
+
+    <br>Example:
+    ```javascript
+    client.getMessages("01234567891011121314", 10);
+    ```
+
+  + ### 🏙 getUsers
+    Gets users from a guild.
+    >Paramaters: guildID (String)
+
+    <br>Example:
+    ```javascript
+    client.getUsers("01234567891011121314");
+    ```
+
+  + ### ❌ removeFromChannel
+    Removes a user from a channel.
+    >Paramaters: channelID (String), userID (String)
+
+    <br>Example:
+    ```javascript
+    client.removeFromChannel("01234567891011121314", "41312111019876543210");
+    ```
+
+  + ### 🏃‍♀️ leaveChannel
+    Leaves a channel.
+    >Paramaters: channelID (String)
+
+    <br>Example:
+    ```javascript
+    client.leaveChannel("01234567891011121314");
+    ```
+  
+  + ### 📞 ring
+    Starts a call with the specified users in a channel.
+    >Paramaters: channelID (String), userIDs (Array)
+
+    <br>Example:
+    ```javascript
+    client.ring("01234567891011121314", [
+      "12549812509818205",
+      "19024578912857987"
+    ]);
+    ```
+
+  + ### 📴 stopRinging
+    Stops ringing the specified users in a channel.
+    >Paramaters: channelID (String), userIDs (Array)
+
+    <br>Example:
+    ```javascript
+    client.stopRinging("01234567891011121314", [
+      "12549812509818205",
+      "19024578912857987"
+    ]);
+    ```
+
+  + ### ➕ addToChannel
+    Adds a user to a channel.
+    >Paramaters: channelID (String), userID (String)
+
+    <br>Example:
+    ```javascript
+    client.addToChannel("01234567891011121314", "41312111019876543210");
+    ```
+
+  + ### 📷 getAvatar
+    Gets the avatar of a user.
+    >Paramaters: userID (String), size (Int | 256)
+
+    <br>Example:
+    ```javascript
+    client.getAvatar("01234567891011121314");
+    ```
+  
+  + ### 🤼 addFriend
+    Sends a friend request to a user.
+    >Paramaters: userID (String)
+
+    <br>Example:
+    ```javascript
+    client.addFriend("01234567891011121314");
+    ```
+
+  + ### ➕ createServer
+    Creates a server with the given options.
+    >Paramaters: options ({name: String, icon: String | null})
+
+    <br>Example:
+    ```javascript
+    client.createServer({name: "My Server", icon: "data:image/png;base64,aGloaSA6Mw=="});
+    ```
+
+  + ### 🖊 editMessage
+    Edits a message.
+    >Paramaters: channelID (String), messageID (String), message (String)
+
+    <br>Example:
+    ```javascript
+    client.editMessage("01234567891011121314", "41312111019876543210", "Edited Message");
+    ```
+
+  + ### 👋 removeFriend
+    Removes a user from the friend list.
+    >Paramaters: userID (String)
+
+    <br>Example:
+    ```javascript
+    client.removeFriend("01234567891011121314");
+    ```
+
+  + ### 📛 renameChannel
+    Renames a channel.
+    >Paramaters: channelID (String), channelName (String)
+
+    <br>Example:
+    ```javascript
+    client.renameChannel("01234567891011121314", "Renamed Channel");
+    ```
+
+  + ### ❎ block
+    Blocks a user.
+    >Paramaters: userID (String)
+
+    <br>Example:
+    ```javascript
+    client.block("01234567891011121314");
+    ```
+
+  + ### ✅ unblock
+    Unblocks a user.
+    >Paramaters: userID (String)
+
+    <br>Example:
+    ```javascript
+    client.unblock("01234567891011121314");
+    ```
+
+  + ### 🚮 deleteMessage
+    Deletes a message.
+    >Paramaters: channelID (String), messageID (String)
+
+    <br>Example:
+    ```javascript
+    client.deleteMessage("01234567891011121314", "41312111019876543210");
+    ```
+
+  + ### 🗿 setStatus
+    Sets the status of the client.
+    >Paramaters: status (String), activites (Array), afk (Boolean | false)
+
+    <br>Example:
+    ```javascript
+    client.setStatus("dnd", [{
+        name: "with the discord API",
+        type: self.status.PLAYING
+    }]);
+    ```
+
+  + ### 🤼 createGroupChat
+    Creates a new channel with the specified users.
+    >Paramaters: userIDs (Array)
+
+    <br>Example:
+    ```javascript
+    client.createGroupChat([
+      "12847128957125",
+      "12905901285798",
+      "64837698943868"
+    ]);
+    ```
+
+  + ### 🎹 startTyping
+    Simulates the client typing in a channel.
+    >Paramaters: channelID (String)
+
+    <br>Example:
+    ```javascript
+    client.startTyping("01234567891011121314");
+    ```
+
+  + ### 📌 pinMessage
+    Pins a message in a channel.
+    >Paramaters: channelID (String), messageID (String)
+
+    <br>Example:
+    ```javascript
+    client.pinMessage("01234567891011121314", "41312111019876543210");
+    ```
+
+  + ### ❌ unpinMessage
+    Unpins a message in a channel.
+    >Paramaters: channelID (String), messageID (String)
+
+    <br>Example:
+    ```javascript
+    client.unpinMessage("01234567891011121314", "41312111019876543210");
+    ```
+
+  + ### 📝 editNote
+    Edits a note for a user.
+    >Paramaters: userID (String), note (String)
+
+    <br>Example:
+    ```javascript
+    client.editNote("01234567891011121314", "Edited Note");
+    ```
+
+  + ### 💾 getChannelData
+    Gets data of a channel.
+    >Paramaters: channelID (String)
+
+    <br>Example:
+    ```javascript
+    client.getChannelData("01234567891011121314");
+    ```
+  
+  + ### 👑 transferOwnership
+    Transfers ownership of a channel to another user.
+    >Paramaters: channelID (String), userID (String)
+
+    <br>Example:
+    ```javascript
+    client.transferOwnership("01234567891011121314", "41312111019876543210");
+    ```

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@imaentity/selfjs",
-    "version": "2.9.11",
+    "version": "3.1.0",
     "description": "Breaking Discord's TOS to bot user accounts.",
     "main": "self.js",
     "repository": {