discord-self-lite 0.1.0 → 0.1.2

package/README.md

@@ -59,11 +59,33 @@ const client = new Client();
 - `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

package/package.json

@@ -1,64 +1,64 @@
-{
-  "name": "discord-self-lite",
-  "version": "0.1.0",
-  "description": "Lightweight Discord selfbot library",
-  "keywords": [
-    "discord",
-    "selfbot",
-    "bot",
-    "api",
-    "websocket",
-    "discord-api",
-    "discord-bot",
-    "discord-selfbot",
-    "lightweight",
-    "nodejs"
-  ],
-  "main": "src/index.js",
-  "files": [
-    "src",
-    "README.md",
-    "LICENSE"
-  ],
-  "exports": {
-    ".": "./src/index.js",
-    "./classes/Client": "./src/classes/Client.js",
-    "./classes/WebhookClient": "./src/connection/webhook/WebhookClient.js"
-  },
-  "engines": {
-    "node": ">=18.13.0"
-  },
-  "scripts": {
-    "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"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/kyan0045/discord-self-lite.git"
-  },
-  "author": {
-    "name": "Kyan Bosman",
-    "email": "contact@kyanbosman.com",
-    "url": "https://github.com/kyan0045"
-  },
-  "license": "GPL-3.0-or-later",
-  "bugs": {
-    "url": "https://github.com/kyan0045/discord-self-lite/issues"
-  },
-  "homepage": "https://github.com/kyan0045/discord-self-lite#readme",
-  "funding": {
-    "type": "github",
-    "url": "https://github.com/sponsors/kyan0045"
-  },
-  "dependencies": {
-    "ws": "^8.18.3"
-  },
-  "devDependencies": {
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-prettier": "^5.5.4",
-    "prettier": "^3.6.2"
-  }
-}
+{
+  "name": "discord-self-lite",
+  "version": "0.1.2",
+  "description": "Lightweight Discord selfbot library",
+  "keywords": [
+    "discord",
+    "selfbot",
+    "bot",
+    "api",
+    "websocket",
+    "discord-api",
+    "discord-bot",
+    "discord-selfbot",
+    "lightweight",
+    "nodejs"
+  ],
+  "main": "src/index.js",
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": "./src/index.js",
+    "./classes/Client": "./src/classes/Client.js",
+    "./classes/WebhookClient": "./src/connection/webhook/WebhookClient.js"
+  },
+  "engines": {
+    "node": ">=18.13.0"
+  },
+  "scripts": {
+    "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"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kyan0045/discord-self-lite.git"
+  },
+  "author": {
+    "name": "Kyan Bosman",
+    "email": "contact@kyanbosman.com",
+    "url": "https://github.com/kyan0045"
+  },
+  "license": "GPL-3.0-or-later",
+  "bugs": {
+    "url": "https://github.com/kyan0045/discord-self-lite/issues"
+  },
+  "homepage": "https://github.com/kyan0045/discord-self-lite#readme",
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/kyan0045"
+  },
+  "dependencies": {
+    "ws": "^8.18.3"
+  },
+  "devDependencies": {
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "prettier": "^3.6.2"
+  }
+}

package/src/classes/Client.js

@@ -36,6 +36,7 @@ class Client extends EventEmitter {
     this.guilds = new Map(); // Cache for Guild instances
     this.channels = new Map(); // Cache for Channel instances
     this.sessionId = null; // Will be set from WebSocket READY event
+    this.user = null; // Will be set from WebSocket READY event
   }
 
   /**

package/src/classes/User.js

@@ -0,0 +1,87 @@
+/**
+ * Represents a Discord user
+ */
+class User {
+  /**
+   * Create a new User instance
+   * @param {Client} client - The Discord client
+   * @param {object} data - Raw user data from Discord API
+   */
+  constructor(client, data) {
+    this.client = client;
+    this.data = data;
+
+    // Copy all user properties
+    for (const [key, value] of Object.entries(data)) {
+      const camelKey = key.replace(/_([a-z])/g, (_, letter) =>
+        letter.toUpperCase(),
+      );
+      this[camelKey] = value;
+    }
+  }
+
+  /**
+   * Set the user's presence/status
+   * @param {object} presence - Presence data
+   * @param {string} [presence.status] - Status: 'online', 'idle', 'dnd', 'invisible'
+   * @param {Array} [presence.activities] - Array of activity objects
+   * @param {boolean} [presence.afk] - Whether the user is AFK
+   * @param {number} [presence.since] - Unix timestamp of when the status was set
+   * @returns {void}
+   */
+  setPresence(presence) {
+    if (!this.client.ws || !this.client.ws.ready) {
+      throw new Error("Client is not connected");
+    }
+
+    const presenceData = {
+      status: presence.status || "online",
+      since: presence.since || 0,
+      activities: presence.activities || [],
+      afk: presence.afk || false,
+    };
+
+    // Send presence update via WebSocket
+    this.client.ws.send({
+      op: 3,
+      d: presenceData,
+    });
+
+    // Update client's stored presence
+    this.client.options.presence = presenceData;
+  }
+
+  /**
+   * Set the user's status (convenience method)
+   * @param {string} status - Status: 'online', 'idle', 'dnd', 'invisible'
+   * @returns {void}
+   */
+  setStatus(status) {
+    this.setPresence({
+      status: status,
+      since: this.client.options.presence.since,
+      activities: this.client.options.presence.activities,
+      afk: this.client.options.presence.afk,
+    });
+  }
+
+  /**
+   * Set the user's activity
+   * @param {object} activity - Activity data
+   * @param {string} activity.name - Activity name
+   * @param {string} [activity.type=0] - Activity type (0=Playing, 1=Streaming, 2=Listening, 3=Watching, 5=Competing)
+   * @param {string} [activity.url] - Stream URL (for type 1)
+   * @returns {void}
+   */
+  setActivity(activity) {
+    const activities = activity ? [activity] : [];
+    this.setPresence({
+      status: this.client.options.presence.status,
+      since: this.client.options.presence.since,
+      activities: activities,
+      afk: this.client.options.presence.afk,
+    });
+  }
+}
+
+module.exports = User;

package/src/connection/rest/methods/clickButton.js

@@ -1,35 +1,36 @@
-async function clickButton(
-  rest,
-  channelId,
-  messageId,
-  applicationId,
-  guildId,
-  customId,
-  sessionId,
-  messageFlags = 0,
-) {
-  // Generate a snowflake-like nonce (simplified version)
-  const nonce = Date.now().toString() + Math.random().toString(36).substring(2, 11);
-
-  const payload = {
-    type: 3, // MESSAGE_COMPONENT
-    nonce,
-    guild_id: guildId,
-    channel_id: channelId,
-    message_id: messageId,
-    application_id: applicationId,
-    session_id: sessionId,
-    message_flags: messageFlags,
-    data: {
-      component_type: 2, // BUTTON
-      custom_id: customId,
-    },
-  };
-
-  return await rest.request("/interactions", {
-    method: "POST",
-    body: JSON.stringify(payload),
-  });
-}
-
-module.exports = clickButton;
+async function clickButton(
+  rest,
+  channelId,
+  messageId,
+  applicationId,
+  guildId,
+  customId,
+  sessionId,
+  messageFlags = 0,
+) {
+  // Generate a snowflake-like nonce (simplified version)
+  const nonce =
+    Date.now().toString() + Math.random().toString(36).substring(2, 11);
+
+  const payload = {
+    type: 3, // MESSAGE_COMPONENT
+    nonce,
+    guild_id: guildId,
+    channel_id: channelId,
+    message_id: messageId,
+    application_id: applicationId,
+    session_id: sessionId,
+    message_flags: messageFlags,
+    data: {
+      component_type: 2, // BUTTON
+      custom_id: customId,
+    },
+  };
+
+  return await rest.request("/interactions", {
+    method: "POST",
+    body: JSON.stringify(payload),
+  });
+}
+
+module.exports = clickButton;

package/src/connection/ws/WebSocket.js

@@ -3,6 +3,7 @@ const { EventEmitter } = require("events");
 const Message = require("../../classes/Message");
 const Guild = require("../../classes/Guild");
 const Channel = require("../../classes/Channel");
+const User = require("../../classes/User");
 const WebSocketError = require("../../classes/WebSocketError");
 
 class DiscordWebSocket extends EventEmitter {
@@ -129,6 +130,7 @@ class DiscordWebSocket extends EventEmitter {
       case "READY":
         this.sessionId = message.d.session_id;
         this.client.sessionId = message.d.session_id;
+        this.client.user = new User(this.client, message.d.user);
         this.ready = true;
         this.client.emit("ready", message.d);
         break;

package/src/index.js

@@ -1,41 +1,41 @@
-/**
- * discord-self-lite - A lightweight Discord selfbot library
- * @module discord-self-lite
- * @version 0.1.0
- * @description A modern, lightweight Discord selfbot library with webhook support, built for Node.js 22+ with zero external dependencies (except ws for WebSocket connections).
- *
- * @example
- * // Import the library
- * const { Client, WebhookClient } = require('discord-self-lite');
- *
- * // Create a Discord client
- * const client = new Client();
- * client.login('your-token');
- *
- * // Create a webhook client
- * const webhook = new WebhookClient('webhook-url');
- * await webhook.send('Hello, world!');
- */
-
-const Client = require("./classes/Client");
-const WebhookClient = require("./connection/webhook/WebhookClient");
-
-/**
- * Main package exports
- * @namespace discord-self-lite
- */
-module.exports = {
-  /**
-   * The main Discord client class for connecting to Discord and handling events
-   * @type {Client}
-   * @see {@link Client}
-   */
-  Client,
-
-  /**
-   * Discord webhook client class for sending messages via webhooks
-   * @type {WebhookClient}
-   * @see {@link WebhookClient}
-   */
-  WebhookClient,
-};
+/**
+ * discord-self-lite - A lightweight Discord selfbot library
+ * @module discord-self-lite
+ * @version 0.1.0
+ * @description A modern, lightweight Discord selfbot library with webhook support, built for Node.js 22+ with zero external dependencies (except ws for WebSocket connections).
+ *
+ * @example
+ * // Import the library
+ * const { Client, WebhookClient } = require('discord-self-lite');
+ *
+ * // Create a Discord client
+ * const client = new Client();
+ * client.login('your-token');
+ *
+ * // Create a webhook client
+ * const webhook = new WebhookClient('webhook-url');
+ * await webhook.send('Hello, world!');
+ */
+
+const Client = require("./classes/Client");
+const WebhookClient = require("./connection/webhook/WebhookClient");
+
+/**
+ * Main package exports
+ * @namespace discord-self-lite
+ */
+module.exports = {
+  /**
+   * The main Discord client class for connecting to Discord and handling events
+   * @type {Client}
+   * @see {@link Client}
+   */
+  Client,
+
+  /**
+   * Discord webhook client class for sending messages via webhooks
+   * @type {WebhookClient}
+   * @see {@link WebhookClient}
+   */
+  WebhookClient,
+};