@hieuxyz/rpc 1.2.0 → 1.2.2

package/README.md

@@ -15,6 +15,7 @@ An easy-to-use and powerful Discord Rich Presence (RPC) library built for the No
 
 ## Outstanding features
 
+-   **Multi-RPC Support:** Display multiple activities simultaneously (e.g., Playing a game AND Listening to music) on a single client connection.
 -   **Flexible Builder Pattern:** Easily build your RPC state with intuitive chainable methods.
 -   **Easy to use:** The `Client` class abstracts away all the complex connection and setup logic, letting you get started with just a few lines of code.
 
@@ -105,6 +106,31 @@ start().catch(err => {
 });
 ```
 
+## Multi-RPC Usage
+
+You can display multiple statuses at once (Discord limits how these are shown, but the data is sent).
+
+```typescript
+// Configure the default RPC
+client.rpc
+    .setName("Visual Studio Code")
+    .setState("Coding...")
+    .setType(0); // Playing
+
+// Create a second RPC instance
+const musicRpc = client.createRPC();
+musicRpc
+    .setName("Spotify")
+    .setDetails("Listening to music")
+    .setApplicationId('12345678901234567') // A different ID is needed than the one already in use
+    .setType(2); // Listening
+
+await client.rpc.build();
+
+// To remove a specific RPC later and free memory:
+// client.removeRPC(musicRpc);
+```
+
 ## Advanced Usage
 
 ### Client Spoofing
@@ -212,6 +238,8 @@ Main builder class for RPC.
 -   `.build()`: Builds and sends the presence payload to Discord.
 -   `.updateRPC()`: Alias for `build()`.
 -   `.clear()`: Clears the Rich Presence from the user's profile and resets the builder.
+-   `.clearCache()`
+-   `.destroy()`
 
 ### Types of images
 
@@ -219,7 +247,7 @@ Main builder class for RPC.
 -   `new LocalImage(filePath, fileName?)`: Upload a photo from your device.
 -   `new RawImage(assetKey)`: Use an existing asset key directly (e.g., `spotify:track_id`).
 -   `new DiscordImage(key)`: Use assets already on Discord (e.g., `mp:attachments/...`).
-
+-   `new ApplicationImage(name)`: Use an asset name from your Discord Application (requires .setApplicationId()).
 ## Author
 
 Developed by **hieuxyz**.

package/dist/hieuxyz/Client.d.ts

@@ -39,10 +39,14 @@ export interface ClientOptions {
  */
 export declare class Client {
     /**
-     * Provides access to RPC constructor methods.
-     * Use this to set your Rich Presence state details.
+     * The default RPC instance.
+     * Use this to set your main Rich Presence state details.
      */
     readonly rpc: HieuxyzRPC;
+    /**
+     * List of all RPC instances managed by this client.
+     */
+    private rpcs;
     /**
      * Information about the logged-in user.
      * Populated after run() resolves.
@@ -57,6 +61,22 @@ export declare class Client {
      * @throws {Error} If no token is provided in the options.
      */
     constructor(options: ClientOptions);
+    /**
+     * Create a new RPC instance.
+     * Use this if you want to display multiple activities simultaneously (Multi-RPC).
+     * @returns {HieuxyzRPC} A new RPC builder instance.
+     */
+    createRPC(): HieuxyzRPC;
+    /**
+     * Removes an RPC instance and cleans up its resources.
+     * @param {HieuxyzRPC} rpcInstance The RPC instance to remove.
+     */
+    removeRPC(rpcInstance: HieuxyzRPC): void;
+    /**
+     * Aggregates activities from all RPC instances and sends them to Discord.
+     * Uses Promise.all for parallel asset resolution.
+     */
+    private sendAllActivities;
     /**
      * Displays information about the library.
      */

package/dist/hieuxyz/Client.js

@@ -20,10 +20,14 @@ const types_1 = require("./gateway/entities/types");
  */
 class Client {
     /**
-     * Provides access to RPC constructor methods.
-     * Use this to set your Rich Presence state details.
+     * The default RPC instance.
+     * Use this to set your main Rich Presence state details.
      */
     rpc;
+    /**
+     * List of all RPC instances managed by this client.
+     */
+    rpcs = [];
     /**
      * Information about the logged-in user.
      * Populated after run() resolves.
@@ -48,14 +52,59 @@ class Client {
             properties: options.properties,
             connectionTimeout: options.connectionTimeout,
         });
-        this.rpc = new HieuxyzRPC_1.HieuxyzRPC(this.websocket, this.imageService);
+        this.rpc = this.createRPC();
         this.printAbout();
     }
+    /**
+     * Create a new RPC instance.
+     * Use this if you want to display multiple activities simultaneously (Multi-RPC).
+     * @returns {HieuxyzRPC} A new RPC builder instance.
+     */
+    createRPC() {
+        const newRpc = new HieuxyzRPC_1.HieuxyzRPC(this.imageService, async () => {
+            await this.sendAllActivities();
+        });
+        this.rpcs.push(newRpc);
+        return newRpc;
+    }
+    /**
+     * Removes an RPC instance and cleans up its resources.
+     * @param {HieuxyzRPC} rpcInstance The RPC instance to remove.
+     */
+    removeRPC(rpcInstance) {
+        const index = this.rpcs.indexOf(rpcInstance);
+        if (index > -1) {
+            rpcInstance.destroy();
+            this.rpcs.splice(index, 1);
+            this.sendAllActivities();
+        }
+    }
+    /**
+     * Aggregates activities from all RPC instances and sends them to Discord.
+     * Uses Promise.all for parallel asset resolution.
+     */
+    async sendAllActivities() {
+        const potentialActivities = await Promise.all(this.rpcs.map((rpc) => rpc.buildActivity()));
+        const activities = potentialActivities.filter((a) => a !== null);
+        let status = 'online';
+        for (let i = this.rpcs.length - 1; i >= 0; i--) {
+            if (this.rpcs[i].currentStatus) {
+                status = this.rpcs[i].currentStatus;
+                break;
+            }
+        }
+        this.websocket.sendActivity({
+            since: 0,
+            activities: activities,
+            status: status,
+            afk: true,
+        });
+    }
     /**
      * Displays information about the library.
      */
     printAbout() {
-        const version = '1.2.0';
+        const version = '1.2.2';
         console.log(`
   _     _                               
  | |__ (_) ___ _   ___  ___   _ ______  
@@ -200,7 +249,7 @@ class Client {
      * even if `alwaysReconnect` is enabled. Defaults to false.
      */
     close(force = false) {
-        this.rpc.stopBackgroundRenewal();
+        this.rpcs.forEach((rpc) => rpc.destroy());
         this.websocket.close(force);
     }
 }

package/dist/hieuxyz/gateway/DiscordWebSocket.d.ts

@@ -22,6 +22,7 @@ export declare class DiscordWebSocket {
     private permanentClose;
     private connectTimeout;
     private resolveReady;
+    private lastHeartbeatAck;
     /**
      * Current logged in user info.
      */

package/dist/hieuxyz/gateway/DiscordWebSocket.js

@@ -59,6 +59,7 @@ class DiscordWebSocket {
     permanentClose = false;
     connectTimeout = null;
     resolveReady = () => { };
+    lastHeartbeatAck = true;
     /**
      * Current logged in user info.
      */
@@ -138,7 +139,7 @@ class DiscordWebSocket {
             this.connectTimeout = null;
         }
         this.isReconnecting = false;
-        if (code === 4004) {
+        if (code === 4004 || code === 4999) {
             this.sessionId = null;
             this.sequence = null;
             this.resumeGatewayUrl = null;
@@ -200,6 +201,7 @@ class DiscordWebSocket {
                 break;
             case OpCode_1.OpCode.HEARTBEAT_ACK:
                 logger_1.logger.info('Heartbeat acknowledged.');
+                this.lastHeartbeatAck = true;
                 break;
             case OpCode_1.OpCode.INVALID_SESSION:
                 logger_1.logger.warn(`Received INVALID_SESSION. Resumable: ${payload.d}`);
@@ -207,6 +209,8 @@ class DiscordWebSocket {
                     this.ws?.close(4000, 'Invalid session, attempting to resume.');
                 }
                 else {
+                    this.sessionId = null;
+                    this.sequence = null;
                     this.ws?.close(4004, 'Invalid session, starting a new session.');
                 }
                 break;
@@ -220,16 +224,23 @@ class DiscordWebSocket {
     }
     startHeartbeating() {
         this.cleanupHeartbeat();
+        this.lastHeartbeatAck = true;
         setTimeout(() => {
             if (this.ws?.readyState === ws_1.default.OPEN) {
                 this.sendHeartbeat();
             }
             this.heartbeatInterval = setInterval(() => {
+                if (!this.lastHeartbeatAck) {
+                    logger_1.logger.warn('Heartbeat ACK missing. Connection is zombie. Terminating to resume...');
+                    this.ws?.terminate();
+                    return;
+                }
                 if (this.ws?.readyState !== ws_1.default.OPEN) {
                     logger_1.logger.warn('Heartbeat skipped: WebSocket is not open.');
                     this.cleanupHeartbeat();
                     return;
                 }
+                this.lastHeartbeatAck = false;
                 this.sendHeartbeat();
             }, this.heartbeatIntervalValue);
         }, this.heartbeatIntervalValue * Math.random());
@@ -303,8 +314,6 @@ class DiscordWebSocket {
         }
     }
     shouldReconnect(code) {
-        if (code === 1006)
-            return true;
         const fatalErrorCodes = [4004, 4010, 4011, 4013, 4014];
         if (fatalErrorCodes.includes(code)) {
             logger_1.logger.error(`Fatal WebSocket error received (code: ${code}). Will not reconnect.`);

package/dist/hieuxyz/rpc/HieuxyzRPC.d.ts

@@ -1,5 +1,4 @@
-import { DiscordWebSocket } from '../gateway/DiscordWebSocket';
-import { SettableActivityType } from '../gateway/entities/types';
+import { Activity, SettableActivityType } from '../gateway/entities/types';
 import { ImageService } from './ImageService';
 import { RpcImage } from './RpcImage';
 /**
@@ -24,12 +23,13 @@ interface RpcSecrets {
     match?: string;
 }
 export type DiscordPlatform = 'desktop' | 'android' | 'ios' | 'samsung' | 'xbox' | 'ps4' | 'ps5' | 'embedded';
+type UpdateCallback = () => Promise<void>;
 /**
  * Class built for creating and managing Discord Rich Presence states.
  */
 export declare class HieuxyzRPC {
-    private websocket;
     private imageService;
+    private onUpdate;
     private activity;
     private assets;
     private status;
@@ -41,13 +41,17 @@ export declare class HieuxyzRPC {
      * Value: The resolved asset key (e.g., "mp:attachments/...").
      */
     private resolvedAssetsCache;
+    /**
+     * Maximum number of items in cache to prevent memory leaks/bloat over long runtime.
+     */
+    private readonly MAX_CACHE_SIZE;
     private renewalInterval;
     /**
      * Cache for Application Assets (Bot Assets).
      * Map<ApplicationID, Map<AssetName, AssetID>>
      */
     private applicationAssetsCache;
-    constructor(websocket: DiscordWebSocket, imageService: ImageService);
+    constructor(imageService: ImageService, onUpdate: UpdateCallback);
     /**
      * Returns the URL of the large image asset, if available.
      * @type {string | null}
@@ -186,9 +190,14 @@ export declare class HieuxyzRPC {
      */
     private ensureAppAssetsLoaded;
     private resolveImage;
-    private buildActivity;
     /**
-     * Build the final Rich Presence payload and send it to Discord.
+     * Publicly accessible method to build the Activity object.
+     * Used by Client to aggregate activities from multiple RPC instances.
+     * @returns {Promise<Activity | null>} The constructed activity or null if empty.
+     */
+    buildActivity(): Promise<Activity | null>;
+    /**
+     * Build the final Rich Presence payload and notify the Client to send it to Discord.
      * @returns {Promise<void>}
      */
     build(): Promise<void>;
@@ -199,11 +208,21 @@ export declare class HieuxyzRPC {
      */
     updateRPC(): Promise<void>;
     /**
-     * Clears the current Rich Presence from Discord and resets the builder state.
-     * This sends an empty activity payload to Discord and then resets all configured
-     * options (name, details, images, etc.) to their default values, allowing you
-     * to build a new presence from scratch.
+     * Clears the current Rich Presence from the user's profile and resets the builder.
      */
     clear(): void;
+    /**
+     * Manually clear the asset cache to free memory.
+     */
+    clearCache(): void;
+    /**
+     * Permanently destroy this RPC instance.
+     * Stops renewal timers and clears memory.
+     */
+    destroy(): void;
+    /**
+     * Get the current status set for this RPC instance.
+     */
+    get currentStatus(): "online" | "dnd" | "idle" | "invisible" | "offline";
 }
 export {};

package/dist/hieuxyz/rpc/HieuxyzRPC.js

@@ -21,8 +21,8 @@ var ActivityFlags;
  * Class built for creating and managing Discord Rich Presence states.
  */
 class HieuxyzRPC {
-    websocket;
     imageService;
+    onUpdate;
     activity = {};
     assets = {};
     status = 'online';
@@ -34,15 +34,19 @@ class HieuxyzRPC {
      * Value: The resolved asset key (e.g., "mp:attachments/...").
      */
     resolvedAssetsCache = new Map();
+    /**
+     * Maximum number of items in cache to prevent memory leaks/bloat over long runtime.
+     */
+    MAX_CACHE_SIZE = 50;
     renewalInterval = null;
     /**
      * Cache for Application Assets (Bot Assets).
      * Map<ApplicationID, Map<AssetName, AssetID>>
      */
     applicationAssetsCache = new Map();
-    constructor(websocket, imageService) {
-        this.websocket = websocket;
+    constructor(imageService, onUpdate) {
         this.imageService = imageService;
+        this.onUpdate = onUpdate;
         this.startBackgroundRenewal();
     }
     /**
@@ -350,7 +354,7 @@ class HieuxyzRPC {
     async renewAssetIfNeeded(cacheKey, assetKey) {
         const expiryTimeMs = this.getExpiryTime(assetKey);
         if (expiryTimeMs && expiryTimeMs < Date.now() + 3600000) {
-            logger_1.logger.info(`Asset ${cacheKey} is expiring soon. Renewing...`);
+            // logger.info(`Asset ${cacheKey} is expiring soon. Renewing...`);
             const assetId = assetKey.split('mp:attachments/')[1];
             const newAsset = await this.imageService.renewImage(assetId);
             if (newAsset) {
@@ -366,7 +370,7 @@ class HieuxyzRPC {
             clearInterval(this.renewalInterval);
         }
         this.renewalInterval = setInterval(async () => {
-            logger_1.logger.info('Running background asset renewal check...');
+            // logger.info('Running background asset renewal check...');
             for (const [cacheKey, assetKey] of this.resolvedAssetsCache.entries()) {
                 await this.renewAssetIfNeeded(cacheKey, assetKey);
             }
@@ -379,7 +383,7 @@ class HieuxyzRPC {
         if (this.renewalInterval) {
             clearInterval(this.renewalInterval);
             this.renewalInterval = null;
-            logger_1.logger.info('Stopped background asset renewal process.');
+            // logger.info('Stopped background asset renewal process.');
         }
     }
     /**
@@ -412,6 +416,12 @@ class HieuxyzRPC {
             }
             return assetId;
         }
+        if (this.resolvedAssetsCache.size >= this.MAX_CACHE_SIZE && !this.resolvedAssetsCache.has(cacheKey)) {
+            const oldestKey = this.resolvedAssetsCache.keys().next().value;
+            if (oldestKey) {
+                this.resolvedAssetsCache.delete(oldestKey);
+            }
+        }
         const cachedAsset = this.resolvedAssetsCache.get(cacheKey);
         if (cachedAsset) {
             return await this.renewAssetIfNeeded(cacheKey, cachedAsset);
@@ -425,7 +435,15 @@ class HieuxyzRPC {
         }
         return resolvedAsset;
     }
+    /**
+     * Publicly accessible method to build the Activity object.
+     * Used by Client to aggregate activities from multiple RPC instances.
+     * @returns {Promise<Activity | null>} The constructed activity or null if empty.
+     */
     async buildActivity() {
+        if (Object.keys(this.activity).length === 0 && !this.assets.large_image && !this.assets.small_image) {
+            return null;
+        }
         const large_image = await this.resolveImage(this.assets.large_image);
         const small_image = await this.resolveImage(this.assets.small_image);
         const finalAssets = {
@@ -449,18 +467,11 @@ class HieuxyzRPC {
         return this.cleanupNulls(finalActivity);
     }
     /**
-     * Build the final Rich Presence payload and send it to Discord.
+     * Build the final Rich Presence payload and notify the Client to send it to Discord.
      * @returns {Promise<void>}
      */
     async build() {
-        const activity = await this.buildActivity();
-        const presencePayload = {
-            since: 0,
-            activities: [activity],
-            status: this.status,
-            afk: true,
-        };
-        this.websocket.sendActivity(presencePayload);
+        await this.onUpdate();
     }
     /**
      * Sends an update to an existing RPC.
@@ -471,25 +482,39 @@ class HieuxyzRPC {
         await this.build();
     }
     /**
-     * Clears the current Rich Presence from Discord and resets the builder state.
-     * This sends an empty activity payload to Discord and then resets all configured
-     * options (name, details, images, etc.) to their default values, allowing you
-     * to build a new presence from scratch.
+     * Clears the current Rich Presence from the user's profile and resets the builder.
      */
     clear() {
-        const clearPayload = {
-            since: 0,
-            activities: [],
-            status: this.status,
-            afk: true,
-        };
-        this.websocket.sendActivity(clearPayload);
-        logger_1.logger.info('Rich Presence cleared from Discord.');
         this.activity = {};
         this.assets = {};
         this.applicationId = '1416676323459469363'; // Reset to default
         this.platform = 'desktop'; // Reset to default
-        logger_1.logger.info('RPC builder has been reset to its initial state.');
+        logger_1.logger.info('RPC instance cleared.');
+        this.onUpdate();
+    }
+    /**
+     * Manually clear the asset cache to free memory.
+     */
+    clearCache() {
+        this.resolvedAssetsCache.clear();
+        this.applicationAssetsCache.clear();
+        logger_1.logger.info('RPC Asset cache has been cleared.');
+    }
+    /**
+     * Permanently destroy this RPC instance.
+     * Stops renewal timers and clears memory.
+     */
+    destroy() {
+        this.stopBackgroundRenewal();
+        this.clearCache();
+        this.activity = {};
+        this.assets = {};
+    }
+    /**
+     * Get the current status set for this RPC instance.
+     */
+    get currentStatus() {
+        return this.status;
     }
 }
 exports.HieuxyzRPC = HieuxyzRPC;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hieuxyz/rpc",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "A Discord Rich Presence library for Node.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -10,8 +10,15 @@
     "LICENSE"
   ],
   "scripts": {
+    "tsx": "tsx",
+    "esbuild": "esbuild",
+    "check": "tsc --noEmit",
+    "dev": "tsx --env-file=.env examples/main.ts",
+    "dev:ts": "node -r ts-node/register --env-file=.env examples/main.ts",
     "build": "tsc",
-    "dev": "node -r ts-node/register --env-file=.env examples/main.ts",
+    "build:es": "esbuild src/index.ts --bundle --platform=node --minify --outfile=dist/index.ts",
+    "build:ex": "esbuild examples/main.ts --bundle --platform=node --minify --outfile=dist/main.js",
+    "start:ex": "node --env-file=.env dist/main.js",
     "lint": "eslint \"src/**/*.ts\" --report-unused-disable-directives --max-warnings 0",
     "lint:fix": "eslint \"src/**/*.ts\" --fix",
     "format": "prettier --write \"src/**/*.ts\" \"examples/**/*.ts\""
@@ -38,11 +45,13 @@
   "devDependencies": {
     "@types/node": "^25.0.3",
     "@types/ws": "^8.18.1",
+    "esbuild": "^0.27.2",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
     "prettier": "^3.7.4",
     "ts-node": "^10.9.2",
+    "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.51.0"
   }