x3ui-api 1.0.1 → 1.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "x3ui-api",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "API client for x3ui panel",
   "main": "src/index.js",
   "types": "src/index.d.ts",

package/src/index.d.ts

@@ -201,9 +201,17 @@ export interface ClientBuilder {
     setTgId(id: string): this;
 
     /**
-     * Build client configuration
+     * Build the client configuration
      */
-    build(): Promise<ClientSettings>;
+    build(): ClientSettings;
+
+    /**
+     * Generate connection link for this client
+     * @param host Host address
+     * @param port Optional port number, defaults to parent's port
+     * @param protocol Optional protocol, defaults to parent's protocol or 'vless'
+     */
+    getLink(host: string, port?: number, protocol?: string): string;
 }
 
 export interface RealityBuilder {
@@ -257,6 +265,13 @@ export interface RealityBuilder {
      */
     addClient(options?: Partial<ClientSettings>): ClientBuilder;
     
+    /**
+     * Get connection link for a client
+     * @param clientIndex Index of the client (defaults to 0)
+     * @param host Optional host address (defaults to listenIP or 'localhost')
+     */
+    getClientLink(clientIndex?: number, host?: string): string;
+
     /**
      * Build the final inbound config
      */

package/src/index.js

@@ -196,7 +196,7 @@ class ClientBuilder {
         return this;
     }
 
-    async build() {
+    build() {
         return {
             id: this.id || crypto.randomUUID(),
             flow: this.flow,
@@ -210,6 +210,28 @@ class ClientBuilder {
             reset: this.reset
         };
     }
+
+    getLink(host, port, protocol) {
+        const id = this.id || crypto.randomUUID();
+        const settings = this.parent.streamSettings?.realitySettings;
+        if (!settings) throw new Error('Reality settings not found');
+
+        port = port || this.parent.port;
+        protocol = protocol || this.parent.protocol || 'vless';
+
+        const params = new URLSearchParams({
+            security: this.parent.streamSettings?.security || 'reality',
+            sni: settings.serverNames[0],
+            fp: settings.settings.fingerprint,
+            pbk: settings.settings.publicKey,
+            sid: settings.shortIds[0],
+            spx: settings.settings.spiderX || '/',
+            type: this.parent.streamSettings?.network || 'tcp',
+            encryption: this.parent.settings?.decryption || 'none'
+        });
+
+        return `${protocol}://${id}@${host}:${port}?${params.toString()}#${encodeURIComponent(this.email || 'default')}`;
+    }
 }
 
 class RealityBuilder {
@@ -303,10 +325,29 @@ class RealityBuilder {
         if (options.totalGB) builder.setTotalGB(options.totalGB);
         if (options.expiryTime) builder.setExpiryTime(options.expiryTime);
         if (options.tgId) builder.setTgId(options.tgId);
+        builder.parent.streamSettings = {
+            realitySettings: {
+                serverNames: this.serverNames,
+                settings: {
+                    fingerprint: this.fingerprint,
+                    publicKey: this.publicKey,
+                    spiderX: '/'
+                },
+                shortIds: this.shortIds
+            }
+        };
         this.clients.push(builder);
         return builder;
     }
 
+    getClientLink(clientIndex = 0, host) {
+        if (clientIndex < 0 || clientIndex >= this.clients.length) {
+            throw new Error('Invalid client index');
+        }
+        const client = this.clients[clientIndex];
+        return client.getLink(host || this.listenIP || 'localhost', this.port);
+    }
+
     generateRandomPort() {
         return Math.floor(Math.random() * (65535 - 1024) + 1024);
     }