@hieuxyz/rpc 1.1.11 → 1.2.0

package/README.md

@@ -1,7 +1,7 @@
 # @hieuxyz/rpc
 
 [![NPM Version](https://img.shields.io/npm/v/@hieuxyz/rpc.svg)](https://www.npmjs.com/package/@hieuxyz/rpc)
-[![License](https://img.shields.io/npm/l/@hieuxyz/rpc.svg)](https://github.com/hieuxyz/rpc/blob/main/LICENSE)
+[![License](https://img.shields.io/npm/l/@hieuxyz/rpc.svg)](https://github.com/hieuxyz00/hieuxyz_rpc/blob/master/LICENSE)
 [![Downloads](https://img.shields.io/npm/dt/@hieuxyz/rpc.svg)](https://www.npmjs.com/package/@hieuxyz/rpc)
 
 An easy-to-use and powerful Discord Rich Presence (RPC) library built for the Node.js environment using TypeScript. This library is designed to simplify the creation and management of custom RPC states for Discord user accounts.

package/dist/hieuxyz/Client.d.ts

@@ -1,5 +1,6 @@
 import { HieuxyzRPC } from './rpc/HieuxyzRPC';
 import { ClientProperties } from './gateway/entities/identify';
+import { DiscordUser } from './gateway/entities/types';
 /**
  * Option to initialize Client.
  */
@@ -42,6 +43,11 @@ export declare class Client {
      * Use this to set your Rich Presence state details.
      */
     readonly rpc: HieuxyzRPC;
+    /**
+     * Information about the logged-in user.
+     * Populated after run() resolves.
+     */
+    user: DiscordUser | null;
     private readonly websocket;
     private readonly imageService;
     private readonly token;
@@ -51,15 +57,23 @@ export declare class Client {
      * @throws {Error} If no token is provided in the options.
      */
     constructor(options: ClientOptions);
+    /**
+     * Displays information about the library.
+     */
+    private printAbout;
     /**
      * Connect to Discord Gateway and prepare the client for RPC updates.
      * This method must be called before sending any Rich Presence updates.
-     * @returns {Promise<void>} A promise will be resolved when the client is ready.
+     * @returns {Promise<DiscordUser>} A promise will be resolved when the client is ready.
      */
-    run(): Promise<void>;
+    run(): Promise<DiscordUser>;
+    private formatters;
+    private formatFlags;
+    private printDynamicTree;
+    private logUserProfile;
     /**
      * Close the connection to Discord Gateway.
-     * @param {boolean} [force=false] - If true, the client will close permanently and will not attempt to reconnect,
+     * @param {boolean} [force=false] - If true, the client closes permanently and will not reconnect.
      * even if `alwaysReconnect` is enabled. Defaults to false.
      */
     close(force?: boolean): void;

package/dist/hieuxyz/Client.js

@@ -5,6 +5,7 @@ const DiscordWebSocket_1 = require("./gateway/DiscordWebSocket");
 const HieuxyzRPC_1 = require("./rpc/HieuxyzRPC");
 const ImageService_1 = require("./rpc/ImageService");
 const logger_1 = require("./utils/logger");
+const types_1 = require("./gateway/entities/types");
 /**
  * The main Client class for interacting with Discord Rich Presence.
  * This is the starting point for creating and managing your RPC state.
@@ -23,6 +24,11 @@ class Client {
      * Use this to set your Rich Presence state details.
      */
     rpc;
+    /**
+     * Information about the logged-in user.
+     * Populated after run() resolves.
+     */
+    user = null;
     websocket;
     imageService;
     token;
@@ -43,21 +49,154 @@ class Client {
             connectionTimeout: options.connectionTimeout,
         });
         this.rpc = new HieuxyzRPC_1.HieuxyzRPC(this.websocket, this.imageService);
+        this.printAbout();
+    }
+    /**
+     * Displays information about the library.
+     */
+    printAbout() {
+        const version = '1.2.0';
+        console.log(`
+  _     _                               
+ | |__ (_) ___ _   ___  ___   _ ______  
+ | '_ \\| |/ _ \\ | | \\ \\/ / | | |_  /  
+ | | | | |  __/ |_| |>  <| |_| |/ /   
+ |_| |_|_|\\___|\\__,_/_/\\_\\\\__, /___|  
+                          |___/       
+  @hieuxyz/rpc v${version}
+  A powerful Discord Rich Presence library.
+  Developed by: hieuxyz
+        `);
     }
     /**
      * Connect to Discord Gateway and prepare the client for RPC updates.
      * This method must be called before sending any Rich Presence updates.
-     * @returns {Promise<void>} A promise will be resolved when the client is ready.
+     * @returns {Promise<DiscordUser>} A promise will be resolved when the client is ready.
      */
     async run() {
         this.websocket.connect();
         logger_1.logger.info('Waiting for Discord session to be ready...');
-        await this.websocket.readyPromise;
+        const user = await this.websocket.readyPromise;
+        this.user = user;
+        this.logUserProfile(user);
         logger_1.logger.info('Client is ready to send Rich Presence updates.');
+        return user;
+    }
+    formatters = {
+        email: (val) => (val ? `\x1b[90m<Hidden>\x1b[0m` : 'null'),
+        phone: (val) => (val ? `\x1b[90m<Hidden>\x1b[0m` : 'null'),
+        avatar: (val, parent) => {
+            if (!val)
+                return 'null';
+            const ext = val.startsWith('a_') ? 'gif' : 'png';
+            const userId = parent?.id;
+            const url = userId ? `https://cdn.discordapp.com/avatars/${userId}/${val}.${ext}` : '';
+            return `"${val}" ${url ? `(\x1b[34m${url}\x1b[0m)` : ''}`;
+        },
+        banner: (val, parent) => {
+            if (!val)
+                return 'null';
+            const ext = val.startsWith('a_') ? 'gif' : 'png';
+            const userId = parent?.id;
+            const url = userId ? `https://cdn.discordapp.com/banners/${userId}/${val}.${ext}` : '';
+            return `"${val}" ${url ? `(\x1b[34m${url}\x1b[0m)` : ''}`;
+        },
+        asset: (val) => {
+            const url = `https://cdn.discordapp.com/avatar-decoration-presets/${val}.png`;
+            return `"${val}" (\x1b[34m${url}\x1b[0m)`;
+        },
+        accent_color: (val) => `${val} (\x1b[33m#${val.toString(16).padStart(6, '0').toUpperCase()}\x1b[0m)`,
+        banner_color: (val) => `\x1b[33m${val}\x1b[0m`,
+        expires_at: (val) => (val ? `${val} (${new Date(val).toLocaleString()})` : 'Never'),
+        premium_type: (val) => {
+            const map = { 0: 'None', 1: 'Classic', 2: 'Nitro', 3: 'Basic' };
+            return `${val} (\x1b[32m${map[val] || 'Unknown'}\x1b[0m)`;
+        },
+        flags: (val) => this.formatFlags(val),
+        public_flags: (val) => this.formatFlags(val),
+        purchased_flags: (val) => `\x1b[33m${val}\x1b[0m`,
+    };
+    formatFlags(flags) {
+        const flagNames = [];
+        if (flags & types_1.UserFlags.STAFF)
+            flagNames.push('Staff');
+        if (flags & types_1.UserFlags.PARTNER)
+            flagNames.push('Partner');
+        if (flags & types_1.UserFlags.HYPESQUAD)
+            flagNames.push('HypeSquad');
+        if (flags & types_1.UserFlags.BUG_HUNTER_LEVEL_1)
+            flagNames.push('BugHunter I');
+        if (flags & types_1.UserFlags.HYPESQUAD_ONLINE_HOUSE_1)
+            flagNames.push('Bravery');
+        if (flags & types_1.UserFlags.HYPESQUAD_ONLINE_HOUSE_2)
+            flagNames.push('Brilliance');
+        if (flags & types_1.UserFlags.HYPESQUAD_ONLINE_HOUSE_3)
+            flagNames.push('Balance');
+        if (flags & types_1.UserFlags.PREMIUM_EARLY_SUPPORTER)
+            flagNames.push('EarlySupporter');
+        if (flags & types_1.UserFlags.BUG_HUNTER_LEVEL_2)
+            flagNames.push('BugHunter II');
+        if (flags & types_1.UserFlags.VERIFIED_DEVELOPER)
+            flagNames.push('VerifiedDev');
+        if (flags & types_1.UserFlags.CERTIFIED_MODERATOR)
+            flagNames.push('CertifiedMod');
+        if (flags & types_1.UserFlags.ACTIVE_DEVELOPER)
+            flagNames.push('ActiveDev');
+        return `${flags} \x1b[36m[${flagNames.length > 0 ? flagNames.join(', ') : 'None'}]\x1b[0m`;
+    }
+    printDynamicTree(obj, prefix = '') {
+        const entries = Object.entries(obj);
+        entries.forEach(([key, value], index) => {
+            const isLastItem = index === entries.length - 1;
+            const connector = isLastItem ? '└── ' : '├── ';
+            const childPrefix = prefix + (isLastItem ? '    ' : '│   ');
+            let displayValue = '';
+            let isObject = false;
+            if (value === null) {
+                displayValue = '\x1b[90mnull\x1b[0m';
+            }
+            else if (typeof value === 'object' && !Array.isArray(value)) {
+                isObject = true;
+                console.log(`${prefix}${connector}\x1b[1m${key}\x1b[0m`);
+                this.printDynamicTree(value, childPrefix);
+            }
+            else if (Array.isArray(value)) {
+                if (value.length > 0 && typeof value[0] !== 'object') {
+                    displayValue = `[ ${value.join(', ')} ]`;
+                }
+                else {
+                    displayValue = `[Array(${value.length})]`;
+                }
+            }
+            else {
+                if (this.formatters[key]) {
+                    displayValue = this.formatters[key](value, obj);
+                }
+                else {
+                    if (typeof value === 'string')
+                        displayValue = `"\x1b[32m${value}\x1b[0m"`;
+                    else if (typeof value === 'boolean')
+                        displayValue = value ? '\x1b[32mtrue\x1b[0m' : '\x1b[31mfalse\x1b[0m';
+                    else if (typeof value === 'number')
+                        displayValue = `\x1b[33m${value}\x1b[0m`;
+                    else
+                        displayValue = String(value);
+                }
+            }
+            if (!isObject) {
+                console.log(`${prefix}${connector}${key}: ${displayValue}`);
+            }
+        });
+    }
+    logUserProfile(user) {
+        logger_1.logger.info('-> User Data:');
+        this.printDynamicTree(user);
+        /*logger.info('-> Raw JSON:');
+        console.log(JSON.stringify(user));*/
     }
     /**
      * Close the connection to Discord Gateway.
-     * @param {boolean} [force=false] - If true, the client will close permanently and will not attempt to reconnect,
+     * @param {boolean} [force=false] - If true, the client closes permanently and will not reconnect.
      * even if `alwaysReconnect` is enabled. Defaults to false.
      */
     close(force = false) {

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

@@ -1,5 +1,5 @@
 import { ClientProperties } from './entities/identify';
-import { PresenceUpdatePayload } from './entities/types';
+import { PresenceUpdatePayload, DiscordUser } from './entities/types';
 interface DiscordWebSocketOptions {
     alwaysReconnect: boolean;
     properties?: ClientProperties;
@@ -22,11 +22,15 @@ export declare class DiscordWebSocket {
     private permanentClose;
     private connectTimeout;
     private resolveReady;
+    /**
+     * Current logged in user info.
+     */
+    user: DiscordUser | null;
     /**
      * A promise will be resolved when the Gateway connection is ready.
      * and received the READY event.
      */
-    readyPromise: Promise<void>;
+    readyPromise: Promise<DiscordUser>;
     /**
      * Create a DiscordWebSocket instance.
      * @param {string} token - Discord user token for authentication.

package/dist/hieuxyz/gateway/DiscordWebSocket.js

@@ -59,6 +59,10 @@ class DiscordWebSocket {
     permanentClose = false;
     connectTimeout = null;
     resolveReady = () => { };
+    /**
+     * Current logged in user info.
+     */
+    user = null;
     /**
      * A promise will be resolved when the Gateway connection is ready.
      * and received the READY event.
@@ -183,12 +187,15 @@ class DiscordWebSocket {
                 if (payload.t === 'READY') {
                     this.sessionId = payload.d.session_id;
                     this.resumeGatewayUrl = payload.d.resume_gateway_url + '/?v=10&encoding=json';
+                    this.user = payload.d.user;
                     logger_1.logger.info(`Session READY. Session ID: ${this.sessionId}. Resume URL set.`);
-                    this.resolveReady();
+                    this.resolveReady(this.user);
                 }
                 else if (payload.t === 'RESUMED') {
                     logger_1.logger.info('The session has been successfully resumed.');
-                    this.resolveReady();
+                    if (this.user) {
+                        this.resolveReady(this.user);
+                    }
                 }
                 break;
             case OpCode_1.OpCode.HEARTBEAT_ACK:

package/dist/hieuxyz/gateway/entities/types.d.ts

@@ -27,6 +27,88 @@ export interface IdentifyPayload {
     properties: IdentifyProperties;
     compress: boolean;
 }
+export declare enum UserFlags {
+    STAFF = 1,
+    PARTNER = 2,
+    HYPESQUAD = 4,
+    BUG_HUNTER_LEVEL_1 = 8,
+    HYPESQUAD_ONLINE_HOUSE_1 = 64,// Bravery
+    HYPESQUAD_ONLINE_HOUSE_2 = 128,// Brilliance
+    HYPESQUAD_ONLINE_HOUSE_3 = 256,// Balance
+    PREMIUM_EARLY_SUPPORTER = 512,
+    TEAM_PSEUDO_USER = 1024,
+    BUG_HUNTER_LEVEL_2 = 16384,
+    VERIFIED_BOT = 65536,
+    VERIFIED_DEVELOPER = 131072,
+    CERTIFIED_MODERATOR = 262144,
+    BOT_HTTP_INTERACTIONS = 524288,
+    ACTIVE_DEVELOPER = 4194304
+}
+export interface DiscordUser {
+    id: string;
+    username: string;
+    discriminator: string;
+    global_name?: string | null;
+    avatar?: string | null;
+    bot?: boolean;
+    system?: boolean;
+    mfa_enabled?: boolean;
+    banner?: string | null;
+    accent_color?: number | null;
+    locale?: string;
+    verified?: boolean;
+    email?: string | null;
+    flags?: number;
+    premium_type?: number;
+    public_flags?: number;
+    bio?: string;
+    phone?: string | null;
+    nsfw_allowed?: boolean;
+    pronouns?: string;
+    mobile?: boolean;
+    desktop?: boolean;
+    clan?: {
+        tag: string;
+        identity_guild_id: string;
+        badge: string;
+        identity_enabled?: boolean;
+    } | null;
+    primary_guild?: {
+        tag: string;
+        identity_guild_id: string;
+        badge: string;
+        identity_enabled?: boolean;
+    } | null;
+    purchased_flags?: number;
+    premium_usage_flags?: number;
+    premium?: boolean;
+    premium_state?: {
+        premium_subscription_type?: number;
+        premium_subscription_group_role?: number;
+        premium_source?: number;
+    } | null;
+    avatar_decoration_data?: {
+        asset: string;
+        sku_id: string;
+        expires_at: number | null;
+    } | null;
+    collectibles?: {
+        nameplate?: {
+            asset: string;
+            label: string;
+            sku_id: string;
+            palette?: string;
+            expires_at?: number | null;
+        };
+    } | null;
+    display_name_styles?: {
+        font_id?: number;
+        effect_id?: number;
+        colors?: number[];
+    } | null;
+    banner_color?: string | null;
+    age_verification_status?: number;
+}
 export interface Activity {
     name: string;
     type: number;

package/dist/hieuxyz/gateway/entities/types.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ActivityType = void 0;
+exports.UserFlags = exports.ActivityType = void 0;
 var ActivityType;
 (function (ActivityType) {
     ActivityType[ActivityType["Playing"] = 0] = "Playing";
@@ -10,3 +10,21 @@ var ActivityType;
     ActivityType[ActivityType["Custom"] = 4] = "Custom";
     ActivityType[ActivityType["Competing"] = 5] = "Competing";
 })(ActivityType || (exports.ActivityType = ActivityType = {}));
+var UserFlags;
+(function (UserFlags) {
+    UserFlags[UserFlags["STAFF"] = 1] = "STAFF";
+    UserFlags[UserFlags["PARTNER"] = 2] = "PARTNER";
+    UserFlags[UserFlags["HYPESQUAD"] = 4] = "HYPESQUAD";
+    UserFlags[UserFlags["BUG_HUNTER_LEVEL_1"] = 8] = "BUG_HUNTER_LEVEL_1";
+    UserFlags[UserFlags["HYPESQUAD_ONLINE_HOUSE_1"] = 64] = "HYPESQUAD_ONLINE_HOUSE_1";
+    UserFlags[UserFlags["HYPESQUAD_ONLINE_HOUSE_2"] = 128] = "HYPESQUAD_ONLINE_HOUSE_2";
+    UserFlags[UserFlags["HYPESQUAD_ONLINE_HOUSE_3"] = 256] = "HYPESQUAD_ONLINE_HOUSE_3";
+    UserFlags[UserFlags["PREMIUM_EARLY_SUPPORTER"] = 512] = "PREMIUM_EARLY_SUPPORTER";
+    UserFlags[UserFlags["TEAM_PSEUDO_USER"] = 1024] = "TEAM_PSEUDO_USER";
+    UserFlags[UserFlags["BUG_HUNTER_LEVEL_2"] = 16384] = "BUG_HUNTER_LEVEL_2";
+    UserFlags[UserFlags["VERIFIED_BOT"] = 65536] = "VERIFIED_BOT";
+    UserFlags[UserFlags["VERIFIED_DEVELOPER"] = 131072] = "VERIFIED_DEVELOPER";
+    UserFlags[UserFlags["CERTIFIED_MODERATOR"] = 262144] = "CERTIFIED_MODERATOR";
+    UserFlags[UserFlags["BOT_HTTP_INTERACTIONS"] = 524288] = "BOT_HTTP_INTERACTIONS";
+    UserFlags[UserFlags["ACTIVE_DEVELOPER"] = 4194304] = "ACTIVE_DEVELOPER";
+})(UserFlags || (exports.UserFlags = UserFlags = {}));

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

@@ -42,6 +42,11 @@ export declare class HieuxyzRPC {
      */
     private resolvedAssetsCache;
     private renewalInterval;
+    /**
+     * Cache for Application Assets (Bot Assets).
+     * Map<ApplicationID, Map<AssetName, AssetID>>
+     */
+    private applicationAssetsCache;
     constructor(websocket: DiscordWebSocket, imageService: ImageService);
     /**
      * Returns the URL of the large image asset, if available.
@@ -99,14 +104,14 @@ export declare class HieuxyzRPC {
     setParty(currentSize: number, maxSize: number): this;
     /**
      * Set large image and its caption text.
-     * @param {string | RpcImage} source - Image source (URL, asset key, or RpcImage object).
+     * @param {string | RpcImage} source - Image source (URL, asset key, Asset Name or RpcImage object).
      * @param {string} [text] - Text displayed when hovering over image.
      * @returns {this}
      */
     setLargeImage(source: string | RpcImage, text?: string): this;
     /**
      * Set the small image and its caption text.
-     * @param {string | RpcImage} source - Image source (URL, asset key, or RpcImage object).
+     * @param {string | RpcImage} source - Image source (URL, asset key, Asset Name or RpcImage object).
      * @param {string} [text] - Text displayed when hovering over image.
      * @returns {this}
      */
@@ -176,6 +181,10 @@ export declare class HieuxyzRPC {
      * Stops the background process that checks for asset renewal.
      */
     stopBackgroundRenewal(): void;
+    /**
+     * Ensure assets are fetched for the current application ID.
+     */
+    private ensureAppAssetsLoaded;
     private resolveImage;
     private buildActivity;
     /**

package/dist/hieuxyz/rpc/HieuxyzRPC.js

@@ -35,6 +35,11 @@ class HieuxyzRPC {
      */
     resolvedAssetsCache = new Map();
     renewalInterval = null;
+    /**
+     * Cache for Application Assets (Bot Assets).
+     * Map<ApplicationID, Map<AssetName, AssetID>>
+     */
+    applicationAssetsCache = new Map();
     constructor(websocket, imageService) {
         this.websocket = websocket;
         this.imageService = imageService;
@@ -77,7 +82,6 @@ class HieuxyzRPC {
         if (assetKey.startsWith('twitch:')) {
             return `https://static-cdn.jtvnw.net/previews-ttv/live_user_${assetKey.substring(7)}.png`;
         }
-        // For assets uploaded to a Discord application
         if (this.applicationId && !assetKey.startsWith('http')) {
             return `https://cdn.discordapp.com/app-assets/${this.applicationId}/${assetKey}.png`;
         }
@@ -106,6 +110,9 @@ class HieuxyzRPC {
         if (source.startsWith('attachments/') || source.startsWith('external/')) {
             return new RpcImage_1.DiscordImage(source);
         }
+        if (/^[a-zA-Z0-9_]+$/.test(source) && !/^\d{17,20}$/.test(source)) {
+            return new RpcImage_1.ApplicationImage(source);
+        }
         return new RpcImage_1.RawImage(source);
     }
     cleanupNulls(obj) {
@@ -185,7 +192,7 @@ class HieuxyzRPC {
     }
     /**
      * Set large image and its caption text.
-     * @param {string | RpcImage} source - Image source (URL, asset key, or RpcImage object).
+     * @param {string | RpcImage} source - Image source (URL, asset key, Asset Name or RpcImage object).
      * @param {string} [text] - Text displayed when hovering over image.
      * @returns {this}
      */
@@ -197,7 +204,7 @@ class HieuxyzRPC {
     }
     /**
      * Set the small image and its caption text.
-     * @param {string | RpcImage} source - Image source (URL, asset key, or RpcImage object).
+     * @param {string | RpcImage} source - Image source (URL, asset key, Asset Name or RpcImage object).
      * @param {string} [text] - Text displayed when hovering over image.
      * @returns {this}
      */
@@ -252,8 +259,8 @@ class HieuxyzRPC {
      * @returns {this}
      */
     setApplicationId(id) {
-        if (!/^\d{18,19}$/.test(id)) {
-            throw new Error('The app ID must be an 18 or 19 digit number.');
+        if (!/^\d{17,20}$/.test(id)) {
+            throw new Error('The app ID must be a valid number string (17-20 digits).');
         }
         this.applicationId = id;
         return this;
@@ -375,16 +382,45 @@ class HieuxyzRPC {
             logger_1.logger.info('Stopped background asset renewal process.');
         }
     }
+    /**
+     * Ensure assets are fetched for the current application ID.
+     */
+    async ensureAppAssetsLoaded() {
+        if (!this.applicationAssetsCache.has(this.applicationId)) {
+            logger_1.logger.info(`Fetching assets for Application ID: ${this.applicationId}...`);
+            const assets = await this.imageService.fetchApplicationAssets(this.applicationId);
+            const assetMap = new Map();
+            assets.forEach((asset) => {
+                assetMap.set(asset.name, asset.id);
+            });
+            this.applicationAssetsCache.set(this.applicationId, assetMap);
+            logger_1.logger.info(`Loaded ${assets.length} assets for Application ID: ${this.applicationId}.`);
+        }
+    }
     async resolveImage(image) {
         if (!image)
             return undefined;
         const cacheKey = image.getCacheKey();
+        if (cacheKey.startsWith('app_asset:')) {
+            await this.ensureAppAssetsLoaded();
+            const assetName = cacheKey.substring('app_asset:'.length);
+            const appAssets = this.applicationAssetsCache.get(this.applicationId);
+            const assetId = appAssets?.get(assetName);
+            if (!assetId) {
+                logger_1.logger.warn(`Asset with name "${assetName}" not found for Application ID ${this.applicationId}.`);
+                return undefined;
+            }
+            return assetId;
+        }
         const cachedAsset = this.resolvedAssetsCache.get(cacheKey);
         if (cachedAsset) {
             return await this.renewAssetIfNeeded(cacheKey, cachedAsset);
         }
         const resolvedAsset = await image.resolve(this.imageService);
         if (resolvedAsset) {
+            if (resolvedAsset.startsWith('app_asset:')) {
+                return this.resolveImage(image);
+            }
             this.resolvedAssetsCache.set(cacheKey, resolvedAsset);
         }
         return resolvedAsset;

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

@@ -1,3 +1,8 @@
+export interface DiscordAsset {
+    id: string;
+    type: number;
+    name: string;
+}
 /**
  * A service to handle external image proxying and local image uploading.
  * Interact with a backend API service to manage image assets.
@@ -28,4 +33,10 @@ export declare class ImageService {
      * @returns {Promise<string | undefined>} The new asset key or undefined if it failed.
      */
     renewImage(assetId: string): Promise<string | undefined>;
+    /**
+     * Fetch all assets for a specific Discord Application.
+     * @param applicationId - The ID of the application.
+     * @returns {Promise<DiscordAsset[]>} List of assets (id, name, type).
+     */
+    fetchApplicationAssets(applicationId: string): Promise<DiscordAsset[]>;
 }

package/dist/hieuxyz/rpc/ImageService.js

@@ -121,5 +121,22 @@ class ImageService {
         }
         return undefined;
     }
+    /**
+     * Fetch all assets for a specific Discord Application.
+     * @param applicationId - The ID of the application.
+     * @returns {Promise<DiscordAsset[]>} List of assets (id, name, type).
+     */
+    async fetchApplicationAssets(applicationId) {
+        try {
+            const url = `https://discord.com/api/v9/oauth2/applications/${applicationId}/assets`;
+            const response = await axios_1.default.get(url);
+            return response.data;
+        }
+        catch (error) {
+            const err = error;
+            logger_1.logger.error(`Failed to fetch assets for application ${applicationId}: ${err.message}. Ensure the App ID is correct.`);
+            return [];
+        }
+    }
 }
 exports.ImageService = ImageService;

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

@@ -54,3 +54,16 @@ export declare class RawImage extends RpcImage {
     resolve(__imageService: ImageService): Promise<string | undefined>;
     getCacheKey(): string;
 }
+/**
+ * Represents an asset uploaded to the Discord Application (Bot Assets).
+ * It will resolve the asset ID by matching the asset name.
+ */
+export declare class ApplicationImage extends RpcImage {
+    assetName: string;
+    /**
+     * @param assetName The name of the asset as defined in the Discord Developer Portal.
+     */
+    constructor(assetName: string);
+    resolve(__imageService: ImageService): Promise<string | undefined>;
+    getCacheKey(): string;
+}

package/dist/hieuxyz/rpc/RpcImage.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RawImage = exports.LocalImage = exports.ExternalImage = exports.DiscordImage = exports.RpcImage = void 0;
+exports.ApplicationImage = exports.RawImage = exports.LocalImage = exports.ExternalImage = exports.DiscordImage = exports.RpcImage = void 0;
 const path = __importStar(require("path"));
 /**
  * Base abstract class for all RPC image types.
@@ -113,3 +113,24 @@ class RawImage extends RpcImage {
     }
 }
 exports.RawImage = RawImage;
+/**
+ * Represents an asset uploaded to the Discord Application (Bot Assets).
+ * It will resolve the asset ID by matching the asset name.
+ */
+class ApplicationImage extends RpcImage {
+    assetName;
+    /**
+     * @param assetName The name of the asset as defined in the Discord Developer Portal.
+     */
+    constructor(assetName) {
+        super();
+        this.assetName = assetName;
+    }
+    async resolve(__imageService) {
+        return `app_asset:${this.assetName}`;
+    }
+    getCacheKey() {
+        return `app_asset:${this.assetName}`;
+    }
+}
+exports.ApplicationImage = ApplicationImage;

package/dist/index.d.ts

@@ -2,6 +2,6 @@ export { Client, ClientOptions } from './hieuxyz/Client';
 export { DiscordWebSocket } from './hieuxyz/gateway/DiscordWebSocket';
 export { HieuxyzRPC } from './hieuxyz/rpc/HieuxyzRPC';
 export { ImageService } from './hieuxyz/rpc/ImageService';
-export { RpcImage, DiscordImage, ExternalImage, LocalImage, RawImage } from './hieuxyz/rpc/RpcImage';
+export { RpcImage, DiscordImage, ExternalImage, LocalImage, RawImage, ApplicationImage } from './hieuxyz/rpc/RpcImage';
 export { logger } from './hieuxyz/utils/logger';
 export * from './hieuxyz/gateway/entities/types';

package/dist/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.logger = exports.RawImage = exports.LocalImage = exports.ExternalImage = exports.DiscordImage = exports.RpcImage = exports.ImageService = exports.HieuxyzRPC = exports.DiscordWebSocket = exports.Client = void 0;
+exports.logger = exports.ApplicationImage = exports.RawImage = exports.LocalImage = exports.ExternalImage = exports.DiscordImage = exports.RpcImage = exports.ImageService = exports.HieuxyzRPC = exports.DiscordWebSocket = exports.Client = void 0;
 var Client_1 = require("./hieuxyz/Client");
 Object.defineProperty(exports, "Client", { enumerable: true, get: function () { return Client_1.Client; } });
 var DiscordWebSocket_1 = require("./hieuxyz/gateway/DiscordWebSocket");
@@ -29,6 +29,7 @@ Object.defineProperty(exports, "DiscordImage", { enumerable: true, get: function
 Object.defineProperty(exports, "ExternalImage", { enumerable: true, get: function () { return RpcImage_1.ExternalImage; } });
 Object.defineProperty(exports, "LocalImage", { enumerable: true, get: function () { return RpcImage_1.LocalImage; } });
 Object.defineProperty(exports, "RawImage", { enumerable: true, get: function () { return RpcImage_1.RawImage; } });
+Object.defineProperty(exports, "ApplicationImage", { enumerable: true, get: function () { return RpcImage_1.ApplicationImage; } });
 var logger_1 = require("./hieuxyz/utils/logger");
 Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return logger_1.logger; } });
 __exportStar(require("./hieuxyz/gateway/entities/types"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hieuxyz/rpc",
-  "version": "1.1.11",
+  "version": "1.2.0",
   "description": "A Discord Rich Presence library for Node.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -32,18 +32,18 @@
   },
   "homepage": "https://github.com/hieuxyz00/hieuxyz_rpc#readme",
   "dependencies": {
-    "axios": "^1.12.2",
+    "axios": "^1.13.2",
     "ws": "^8.18.3"
   },
   "devDependencies": {
-    "@types/node": "^24.6.2",
+    "@types/node": "^25.0.3",
     "@types/ws": "^8.18.1",
-    "eslint": "^9.36.0",
+    "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
-    "prettier": "^3.6.2",
+    "prettier": "^3.7.4",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.45.0"
+    "typescript-eslint": "^8.51.0"
   }
 }