x3ui-api 1.0.8-1 → 1.1.0

package/README.md

@@ -2,6 +2,10 @@
 
 A Node.js client for interacting with the x3ui panel API. This library provides a simple interface to manage X-UI inbounds, clients, and system statistics.
 
+## Requirements
+
+- x3-ui v2.7.0 or higher (for lover x3-ui versions, use v1.0.9-1 version of this library)
+
 ## Installation
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "x3ui-api",
-  "version": "1.0.8-1",
+  "version": "1.1.0",
   "description": "API client for x3ui panel",
   "main": "src/index.js",
   "types": "src/index.d.ts",
@@ -11,8 +11,8 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "axios": "^1.8.2",
-    "form-data": "^4.0.0"
+    "axios": "1.12.0",
+    "form-data": "4.0.4"
   },
   "devDependencies": {
     "@types/node": "^20.11.5"

package/src/core/X3UIClient.js

@@ -46,7 +46,7 @@ module.exports = class X3UIClient {
         if (!this.isAuthed) {
             await this.login();
         }
-        const response = await this.client.post('/server/status');
+        const response = await this.client.post('/panel/api/server/status');
         return response.data.obj;
     }
 
@@ -153,13 +153,14 @@ module.exports = class X3UIClient {
 
     /**
      * Get new X25519 certificate
+     * @deprecated Use {@link getNewVlessEnc} for new versions of X3-UI
      * @returns {Promise<{privateKey: string, publicKey: string}>} New X25519 key pair
      */
     async getNewX25519Cert() {
         if (!this.isAuthed) {
             await this.login();
         }
-        const response = await this.client.post('/server/getNewX25519Cert');
+        const response = await this.client.post('/panel/api/server/getNewX25519Cert');
         return response.data.obj;
     }
 }

package/src/protocols/vmess/VmessBuilder.d.ts

@@ -65,6 +65,13 @@ export default class VmessBuilder {
      */
     getClientLink(clientIndex?: number, host?: string): string;
 
+    /**
+     * Get connection link for a client
+     * @param email Email of the client
+     * @param host Optional host address (defaults to listenIP or 'localhost')
+     */
+    getClientLinkByEmail(email: string, host?: string): string;
+
     /**
      * Generate a random port number
      */

package/src/protocols/vmess/VmessBuilder.js

@@ -130,6 +130,14 @@ module.exports = class VmessBuilder {
         return client.getLink(host || this.listenIP || 'localhost', port || this.port);
     }
 
+    getClientLinkByEmail(email, host) {
+        const client = this.clients.find(client => client.email === email);
+        if (!client) {
+            throw new Error('Client not found');
+        }
+        return client.getLink(host || this.listenIP || 'localhost', this.port);
+    }
+
     generateRandomPort() {
         return Math.floor(Math.random() * (65535 - 1024) + 1024);
     }

package/src/protocols/wireguard/WireguardBuilder.d.ts

@@ -87,6 +87,13 @@ export default class WireguardBuilder {
      * @returns A formatted connection link string
      */
     getClientLink(clientIndex?: number, host?: string, port?: number): string;
+
+    /**
+     * Get connection link for a client
+     * @param email Email of the client
+     * @param host Optional host address (defaults to listenIP or 'localhost')
+     */
+    getClientLinkByEmail(email: string, host?: string): string;
     
     /**
      * Generates a configuration file for a client.

package/src/protocols/wireguard/WireguardBuilder.js

@@ -132,6 +132,14 @@ module.exports = class WireguardBuilder {
         return client.getLink(host || this.listenIP || 'localhost', port || this.port);
     }
 
+    getClientLinkByEmail(email, host) {
+        const client = this.clients.find(client => client.email === email);
+        if (!client) {
+            throw new Error('Client not found');
+        }
+        return client.getLink(host || this.listenIP || 'localhost', this.port);
+    }
+
     getClientConfig(clientIndex = 0, host, port) {
         if (clientIndex < 0 || clientIndex >= this.clients.length) {
             throw new Error('Invalid client index');