@kissesses/xtls-sdk 0.16.0

package/build/src/stats/models/get-user-online-status/get-user-online-status.response.model.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetUserOnlineStatusResponseModel = void 0;
+class GetUserOnlineStatusResponseModel {
+    constructor(data) {
+        this.online = data;
+    }
+}
+exports.GetUserOnlineStatusResponseModel = GetUserOnlineStatusResponseModel;

package/build/src/stats/models/get-user-online-status/index.d.ts

@@ -0,0 +1,2 @@
+export * from './get-user-online-status.response.model';
+//# sourceMappingURL=index.d.ts.map

package/build/src/stats/models/get-user-online-status/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/stats/models/get-user-online-status/index.ts"],"names":[],"mappings":"AAAA,cAAc,yCAAyC,CAAC"}

package/build/src/stats/models/get-user-online-status/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+__exportStar(require("./get-user-online-status.response.model"), exports);

package/build/src/stats/models/get-user-stats/get-user-stats.response.model.d.ts

@@ -0,0 +1,26 @@
+import { QueryStatsResponse } from '../../../xray-protos/app/stats/command/command';
+import { IUserStat } from './interfaces';
+/**
+ * Model class for handling user statistics response data from the Xray server.
+ */
+export declare class GetUserStatsResponseModel {
+    /**
+     * The user statistics data, or null if no data is available.
+     */
+    user: IUserStat | null;
+    /**
+     * Creates a new GetUserStatsResponseModel instance.
+     *
+     * @param data - The raw query stats response from the Xray server
+     */
+    constructor(data: QueryStatsResponse);
+    /**
+     * Parses the raw stats response data into formatted user statistics.
+     *
+     * @param data - The raw query stats response to parse
+     * @returns An array of formatted user statistics
+     * @private
+     */
+    private parseData;
+}
+//# sourceMappingURL=get-user-stats.response.model.d.ts.map

package/build/src/stats/models/get-user-stats/get-user-stats.response.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-user-stats.response.model.d.ts","sourceRoot":"","sources":["../../../../../src/stats/models/get-user-stats/get-user-stats.response.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC;;GAEG;AACH,qBAAa,yBAAyB;IAClC;;OAEG;IACI,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IAE9B;;;;OAIG;gBACS,IAAI,EAAE,kBAAkB;IAKpC;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;CAwBpB"}

package/build/src/stats/models/get-user-stats/get-user-stats.response.model.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetUserStatsResponseModel = void 0;
+/**
+ * Model class for handling user statistics response data from the Xray server.
+ */
+class GetUserStatsResponseModel {
+    /**
+     * Creates a new GetUserStatsResponseModel instance.
+     *
+     * @param data - The raw query stats response from the Xray server
+     */
+    constructor(data) {
+        const users = this.parseData(data);
+        this.user = users[0] ?? null;
+    }
+    /**
+     * Parses the raw stats response data into formatted user statistics.
+     *
+     * @param data - The raw query stats response to parse
+     * @returns An array of formatted user statistics
+     * @private
+     */
+    parseData(data) {
+        const usersMap = new Map();
+        for (const stat of data.stat) {
+            const nameParts = stat.name.split('>>>');
+            const username = nameParts[1];
+            const type = nameParts[3];
+            const value = stat.value;
+            let user = usersMap.get(username);
+            if (!user) {
+                user = { username, uplink: 0, downlink: 0 };
+                usersMap.set(username, user);
+            }
+            if (type === 'uplink') {
+                user.uplink += value;
+            }
+            else if (type === 'downlink') {
+                user.downlink += value;
+            }
+        }
+        return Array.from(usersMap.values());
+    }
+}
+exports.GetUserStatsResponseModel = GetUserStatsResponseModel;

package/build/src/stats/models/get-user-stats/index.d.ts

@@ -0,0 +1,2 @@
+export * from './get-user-stats.response.model';
+//# sourceMappingURL=index.d.ts.map

package/build/src/stats/models/get-user-stats/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/stats/models/get-user-stats/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC"}

package/build/src/stats/models/get-user-stats/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+__exportStar(require("./get-user-stats.response.model"), exports);

package/build/src/stats/models/get-user-stats/interfaces/index.d.ts

@@ -0,0 +1,2 @@
+export * from './user.interface';
+//# sourceMappingURL=index.d.ts.map

package/build/src/stats/models/get-user-stats/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/stats/models/get-user-stats/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/build/src/stats/models/get-user-stats/interfaces/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+__exportStar(require("./user.interface"), exports);

package/build/src/stats/models/get-user-stats/interfaces/user.interface.d.ts

@@ -0,0 +1,6 @@
+export interface IUserStat {
+    username: string;
+    uplink: number;
+    downlink: number;
+}
+//# sourceMappingURL=user.interface.d.ts.map

package/build/src/stats/models/get-user-stats/interfaces/user.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.interface.d.ts","sourceRoot":"","sources":["../../../../../../src/stats/models/get-user-stats/interfaces/user.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACpB"}

package/build/src/stats/models/get-user-stats/interfaces/user.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/src/stats/models/get-users-stats/get-users-stats.response.model.d.ts

@@ -0,0 +1,50 @@
+import { GetUsersStatsResponse } from '../../../xray-protos/app/stats/command/command';
+export interface UserIPEntry {
+    ip: string;
+    lastSeen: Date;
+}
+export interface UserTrafficStat {
+    uplink: number;
+    downlink: number;
+}
+export interface UserStat {
+    /**
+     * User identifier. Maps to the `email` field from Xray core.
+     */
+    userId: string;
+    ips: UserIPEntry[];
+    traffic?: UserTrafficStat;
+}
+/**
+ * Model class for handling user statistics response data from the Xray server.
+ */
+export declare class GetUsersStatsResponseModel {
+    /**
+     * The user statistics data, or null if no data is available.
+     */
+    users: UserStat[] | null;
+    /**
+     * Creates a new GetUserStatsResponseModel instance.
+     *
+     * @param data - The raw query stats response from the Xray server
+     */
+    constructor(data: GetUsersStatsResponse);
+    /**
+     * Creates a model instance from an already-parsed array of user stats,
+     * bypassing the native `GetUsersStatsResponse` parser.
+     *
+     * Intended for code paths that build `UserStat[]` from other sources
+     * (e.g. the legacy fallback that combines `GetAllOnlineUsers` and
+     * `GetStatsOnlineIpList`).
+     */
+    static fromUserStats(users: UserStat[]): GetUsersStatsResponseModel;
+    /**
+     * Parses the raw stats response data into formatted user statistics.
+     *
+     * @param data - The raw query stats response to parse
+     * @returns An array of formatted user statistics
+     * @private
+     */
+    private parseData;
+}
+//# sourceMappingURL=get-users-stats.response.model.d.ts.map

package/build/src/stats/models/get-users-stats/get-users-stats.response.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-users-stats.response.model.d.ts","sourceRoot":"","sources":["../../../../../src/stats/models/get-users-stats/get-users-stats.response.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AAEvF,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACrB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,WAAW,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,eAAe,CAAC;CAC7B;AACD;;GAEG;AACH,qBAAa,0BAA0B;IACnC;;OAEG;IACI,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAEhC;;;;OAIG;gBACS,IAAI,EAAE,qBAAqB;IAKvC;;;;;;;OAOG;WACW,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,0BAA0B;IAQ1E;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;CAcpB"}

package/build/src/stats/models/get-users-stats/get-users-stats.response.model.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetUsersStatsResponseModel = void 0;
+/**
+ * Model class for handling user statistics response data from the Xray server.
+ */
+class GetUsersStatsResponseModel {
+    /**
+     * Creates a new GetUserStatsResponseModel instance.
+     *
+     * @param data - The raw query stats response from the Xray server
+     */
+    constructor(data) {
+        const users = this.parseData(data);
+        this.users = users;
+    }
+    /**
+     * Creates a model instance from an already-parsed array of user stats,
+     * bypassing the native `GetUsersStatsResponse` parser.
+     *
+     * Intended for code paths that build `UserStat[]` from other sources
+     * (e.g. the legacy fallback that combines `GetAllOnlineUsers` and
+     * `GetStatsOnlineIpList`).
+     */
+    static fromUserStats(users) {
+        const model = Object.create(GetUsersStatsResponseModel.prototype);
+        model.users = users;
+        return model;
+    }
+    /**
+     * Parses the raw stats response data into formatted user statistics.
+     *
+     * @param data - The raw query stats response to parse
+     * @returns An array of formatted user statistics
+     * @private
+     */
+    parseData(data) {
+        const users = [];
+        for (const user of data.users) {
+            const userStat = {
+                userId: user.email,
+                ips: user.ips.map((ip) => ({ ip: ip.ip, lastSeen: new Date(ip.lastSeen * 1000) })),
+                traffic: user.traffic
+                    ? { uplink: user.traffic.uplink, downlink: user.traffic.downlink }
+                    : undefined,
+            };
+            users.push(userStat);
+        }
+        return users;
+    }
+}
+exports.GetUsersStatsResponseModel = GetUsersStatsResponseModel;

package/build/src/stats/models/get-users-stats/index.d.ts

@@ -0,0 +1,2 @@
+export * from './get-users-stats.response.model';
+//# sourceMappingURL=index.d.ts.map

package/build/src/stats/models/get-users-stats/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/stats/models/get-users-stats/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC"}

package/build/src/stats/models/get-users-stats/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+__exportStar(require("./get-users-stats.response.model"), exports);

package/build/src/stats/models/index.d.ts

@@ -0,0 +1,10 @@
+export * from './get-sys-stats';
+export * from './get-all-users-stats';
+export * from './get-user-stats';
+export * from './get-user-online-status';
+export * from './get-all-inbounds-stats';
+export * from './get-inbound-stats';
+export * from './get-all-outbounds-stats';
+export * from './get-outbound-stats';
+export * from './get-users-stats';
+//# sourceMappingURL=index.d.ts.map

package/build/src/stats/models/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/stats/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC"}

package/build/src/stats/models/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+__exportStar(require("./get-sys-stats"), exports);
+__exportStar(require("./get-all-users-stats"), exports);
+__exportStar(require("./get-user-stats"), exports);
+__exportStar(require("./get-user-online-status"), exports);
+__exportStar(require("./get-all-inbounds-stats"), exports);
+__exportStar(require("./get-inbound-stats"), exports);
+__exportStar(require("./get-all-outbounds-stats"), exports);
+__exportStar(require("./get-outbound-stats"), exports);
+__exportStar(require("./get-users-stats"), exports);

package/build/src/stats/stats.service.d.ts

@@ -0,0 +1,271 @@
+import { Channel } from 'nice-grpc';
+import { GetAllUsersStatsResponseModel, GetUserStatsResponseModel, GetSysStatsResponseModel, GetUserOnlineStatusResponseModel, GetAllInboundsStatsResponseModel, GetInboundStatsResponseModel, GetAllOutboundsStatsResponseModel, GetOutboundStatsResponseModel, GetUsersStatsResponseModel } from './models';
+import { StatsServiceClient } from '../xray-protos/app/stats/command/command';
+import { ISdkResponse } from '../common/types';
+/**
+ * Service class for interacting with Xray server statistics.
+ * Provides methods to retrieve system and user statistics.
+ *
+ * @example
+ * ```typescript
+ * // Create a new StatsService instance
+ * const stats = new StatsService(channel);
+ *
+ * // Get system stats
+ * const sysStats = await stats.getSysStats();
+ *
+ * // Get all users stats
+ * const allUsersStats = await stats.getAllUsersStats();
+ *
+ * // Get specific user stats
+ * const userStats = await stats.getUserStats('username123');
+ *
+ * // Check if user is online
+ * const isOnline = await stats.getUserOnlineStatus('username123');
+ * ```
+ */
+export declare class StatsService {
+    private readonly channel;
+    /**
+     * The gRPC client instance for making stats-related requests to the Xray server
+     * @private
+     */
+    private readonly client;
+    /**
+     * Cached flag indicating whether the remote Xray server supports the
+     * `GetUsersStats` unary method. `null` means "not probed yet", `true` means
+     * the method is available, `false` means the legacy fallback should be used.
+     *
+     * The flag is cached for the lifetime of this instance — if the Xray core
+     * is upgraded without re-creating the SDK, a manual re-instantiation is
+     * required to re-detect support.
+     * @private
+     */
+    private supportsGetUsersStats;
+    /**
+     * Creates a new StatsService instance
+     * @param channel - The gRPC channel to use for communication with the Xray server
+     */
+    constructor(channel: Channel);
+    /**
+     * Retrieves system statistics from the Xray server.
+     * This includes information about the system's overall performance and resource usage.
+     *
+     * @returns {Promise<ISdkResponse<GetSysStatsResponseModel>>} A promise that resolves to:
+     * - On success: An object with `isOk: true` and `data` containing the system stats
+     * - On failure: An object with `isOk: false` and error details from STATS_ERRORS
+     *
+     * @example
+     * ```typescript
+     * const stats = new StatsService(channel);
+     * const response = await stats.getSysStats();
+     *
+     * if (response.isOk) {
+     *   console.log(response.data); // GetSysStatsResponseModel
+     * } else {
+     *   console.error(response.message); // Error message
+     * }
+     * ```
+     */
+    getSysStats(): Promise<ISdkResponse<GetSysStatsResponseModel>>;
+    /**
+     * Retrieves statistics for all users from the Xray server.
+     * This provides a comprehensive view of all user activities and their resource usage.
+     *
+     * @param {boolean} reset - Whether to reset the statistics after retrieving them. Defaults to false.
+     * @returns {Promise<ISdkResponse<GetAllUsersStatsResponseModel>>} A promise that resolves to:
+     * - On success: An object with `isOk: true` and `data` containing user stats
+     * - On failure: An object with `isOk: false` and error details from STATS_ERRORS
+     *
+     * @example
+     * ```typescript
+     * const stats = new StatsService(channel);
+     *
+     * // Get stats without resetting
+     * const response = await stats.getAllUsersStats();
+     *
+     * // Get stats and reset them
+     * const responseWithReset = await stats.getAllUsersStats(true);
+     *
+     * if (response.isOk) {
+     *   console.log(response.data.users); // Array of user statistics
+     * } else {
+     *   console.error(response.message); // Error message
+     * }
+     * ```
+     */
+    getAllUsersStats(reset?: boolean): Promise<ISdkResponse<GetAllUsersStatsResponseModel>>;
+    /**
+     * Retrieves statistics for a specific user from the Xray server.
+     * This includes detailed information about the user's network usage, connections, and other metrics.
+     *
+     * @param {string} username - The username to get statistics for
+     * @param {boolean} reset - Whether to reset the statistics after retrieving them. Defaults to false.
+     * @returns {Promise<ISdkResponse<GetUserStatsResponseModel>>} A promise that resolves to:
+     * - On success: An object with `isOk: true` and `data` containing the user's stats
+     * - On failure: An object with `isOk: false` and error details from STATS_ERRORS
+     *
+     * @example
+     * ```typescript
+     * const stats = new StatsService(channel);
+     *
+     * // Get user stats without resetting
+     * const response = await stats.getUserStats('username123');
+     *
+     * // Get user stats and reset them
+     * const responseWithReset = await stats.getUserStats('username123', true);
+     *
+     * if (response.isOk) {
+     *   console.log(response.data.user); // User statistics
+     * } else {
+     *   console.error(response.message); // Error message
+     * }
+     * ```
+     */
+    getUserStats(username: string, reset?: boolean): Promise<ISdkResponse<GetUserStatsResponseModel>>;
+    /**
+     * Checks if a specific user is currently online on the Xray server.
+     * This method queries the server's real-time connection status for the specified user.
+     *
+     * @param {string} username - The username to check online status for
+     * @returns {Promise<ISdkResponse<GetUserOnlineStatusResponseModel>>} A promise that resolves to:
+     * - On success: An object with `isOk: true` and `data` containing the user's online status (`data.online`)
+     * - On failure: An object with `isOk: false` and error details from STATS_ERRORS
+     *
+     * @example
+     * ```typescript
+     * const stats = new StatsService(channel);
+     * const response = await stats.getUserOnlineStatus('username123');
+     *
+     * if (response.isOk) {
+     *   if (response.data.online) {
+     *     console.log('User is online');
+     *   } else {
+     *     console.log('User is offline');
+     *   }
+     * } else {
+     *   console.error(response.message); // Error message
+     * }
+     * ```
+     */
+    getUserOnlineStatus(username: string): Promise<ISdkResponse<GetUserOnlineStatusResponseModel>>;
+    /**
+     * Gets statistics for all inbound connections.
+     *
+     * @param reset - Whether to reset the statistics after retrieving them. Defaults to false.
+     * @returns A promise that resolves to an ISdkResponse containing:
+     * - On success: An object with `isOk: true` and data containing an array of inbound stats
+     * - On failure: An object with `isOk: false` and error details from STATS_ERRORS
+     *
+     * @example
+     * ```typescript
+     * const stats = new StatsService(channel);
+     * const response = await stats.getAllInboundsStats();
+     *
+     * if (response.isOk) {
+     *   console.log('Inbound stats:', response.data.inbounds);
+     * } else {
+     *   console.error(response.message); // Error message
+     * }
+     * ```
+     */
+    getAllInboundsStats(reset?: boolean): Promise<ISdkResponse<GetAllInboundsStatsResponseModel>>;
+    /**
+     * Gets statistics for a specific inbound connection.
+     *
+     * @param inbound - The name/tag of the inbound connection to get stats for
+     * @param reset - Whether to reset the statistics after retrieving them. Defaults to false.
+     * @returns A promise that resolves to an ISdkResponse containing:
+     * - On success: An object with `isOk: true` and data containing the inbound stats
+     * - On failure: An object with `isOk: false` and error details from STATS_ERRORS
+     *
+     * @example
+     * ```typescript
+     * const stats = new StatsService(channel);
+     * const response = await stats.getInboundStats('http_in');
+     *
+     * if (response.isOk) {
+     *   console.log('Inbound stats:', response.data.stats);
+     * } else {
+     *   console.error(response.message); // Error message
+     * }
+     * ```
+     */
+    getInboundStats(inbound: string, reset?: boolean): Promise<ISdkResponse<GetInboundStatsResponseModel>>;
+    /**
+     * Gets statistics for all outbound connections.
+     *
+     * @param reset - Whether to reset the statistics after retrieving them. Defaults to false.
+     * @returns A promise that resolves to an ISdkResponse containing:
+     * - On success: An object with `isOk: true` and data containing an array of outbound stats
+     * - On failure: An object with `isOk: false` and error details from STATS_ERRORS
+     *
+     * @example
+     * ```typescript
+     * const stats = new StatsService(channel);
+     * const response = await stats.getAllOutboundsStats();
+     *
+     * if (response.isOk) {
+     *   console.log('Outbound stats:', response.data.outbounds);
+     * } else {
+     *   console.error(response.message); // Error message
+     * }
+     * ```
+     */
+    getAllOutboundsStats(reset?: boolean): Promise<ISdkResponse<GetAllOutboundsStatsResponseModel>>;
+    /**
+     * Gets statistics for a specific outbound connection.
+     *
+     * @param outbound - The name/tag of the outbound connection to get stats for
+     * @param reset - Whether to reset the statistics after retrieving them. Defaults to false.
+     * @returns A promise that resolves to an ISdkResponse containing:
+     * - On success: An object with `isOk: true` and data containing the outbound stats
+     * - On failure: An object with `isOk: false` and error details from STATS_ERRORS
+     *
+     * @example
+     * ```typescript
+     * const stats = new StatsService(channel);
+     * const response = await stats.getOutboundStats('http_out');
+     *
+     * if (response.isOk) {
+     *   console.log('Outbound stats:', response.data.stats);
+     * } else {
+     *   console.error(response.message); // Error message
+     * }
+     * ```
+     */
+    getOutboundStats(outbound: string, reset?: boolean): Promise<ISdkResponse<GetOutboundStatsResponseModel>>;
+    /**
+     * Retrieves per-user statistics (online IP list and, optionally, traffic)
+     * from the Xray server.
+     *
+     * Prefers the native `GetUsersStats` gRPC method introduced in recent
+     * Xray-core versions. If the server replies with `UNIMPLEMENTED` (i.e. the
+     * method is missing), transparently falls back to the legacy approach of
+     * combining `GetAllOnlineUsers` + `GetStatsOnlineIpList`. The detection
+     * result is cached for the lifetime of this service instance, so the
+     * `UNIMPLEMENTED` round-trip happens at most once.
+     *
+     * Note: the `includeTraffic` flag is honored only on the native path. In
+     * legacy mode traffic is always returned as `undefined`, since the old
+     * endpoints do not expose per-user traffic in a single call.
+     *
+     * @param includeTraffic - Whether to request traffic counters alongside IPs (native path only).
+     * @param reset - Whether to reset the stats after retrieving them.
+     */
+    getUsersStats(includeTraffic?: boolean, reset?: boolean): Promise<ISdkResponse<GetUsersStatsResponseModel>>;
+    /**
+     * Legacy fallback for {@link getUsersStats}. Uses `GetAllOnlineUsers` to
+     * enumerate currently connected users and then queries
+     * `GetStatsOnlineIpList` for each of them in parallel with a bounded
+     * worker pool. Always returns `traffic: undefined` for every user.
+     * @private
+     */
+    private getUsersStatsLegacy;
+    /**
+     * Gets the raw gRPC client for direct access to all stats service methods
+     * @returns The underlying StatsServiceClient instance
+     */
+    get rawClient(): StatsServiceClient;
+}
+//# sourceMappingURL=stats.service.d.ts.map

package/build/src/stats/stats.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.service.d.ts","sourceRoot":"","sources":["../../../src/stats/stats.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAqC,MAAM,WAAW,CAAC;AAEvE,OAAO,EACH,6BAA6B,EAC7B,yBAAyB,EACzB,wBAAwB,EACxB,gCAAgC,EAChC,gCAAgC,EAChC,4BAA4B,EAC5B,iCAAiC,EACjC,6BAA6B,EAC7B,0BAA0B,EAE7B,MAAM,UAAU,CAAC;AAClB,OAAO,EAEH,kBAAkB,EACrB,MAAM,0CAA0C,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,YAAY;IAuBT,OAAO,CAAC,QAAQ,CAAC,OAAO;IAtBpC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAE5C;;;;;;;;;OASG;IACH,OAAO,CAAC,qBAAqB,CAAwB;IAErD;;;OAGG;gBAC0B,OAAO,EAAE,OAAO;IAI7C;;;;;;;;;;;;;;;;;;;OAmBG;IACU,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC,wBAAwB,CAAC,CAAC;IAoB3E;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACU,gBAAgB,CACzB,KAAK,GAAE,OAAe,GACvB,OAAO,CAAC,YAAY,CAAC,6BAA6B,CAAC,CAAC;IAuBvD;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACU,YAAY,CACrB,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,OAAe,GACvB,OAAO,CAAC,YAAY,CAAC,yBAAyB,CAAC,CAAC;IAuBnD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACU,mBAAmB,CAC5B,QAAQ,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,CAAC,gCAAgC,CAAC,CAAC;IA8B1D;;;;;;;;;;;;;;;;;;;OAmBG;IACU,mBAAmB,CAC5B,KAAK,GAAE,OAAe,GACvB,OAAO,CAAC,YAAY,CAAC,gCAAgC,CAAC,CAAC;IAuB1D;;;;;;;;;;;;;;;;;;;;OAoBG;IACU,eAAe,CACxB,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,OAAe,GACvB,OAAO,CAAC,YAAY,CAAC,4BAA4B,CAAC,CAAC;IAuBtD;;;;;;;;;;;;;;;;;;;OAmBG;IACU,oBAAoB,CAC7B,KAAK,GAAE,OAAe,GACvB,OAAO,CAAC,YAAY,CAAC,iCAAiC,CAAC,CAAC;IAuB3D;;;;;;;;;;;;;;;;;;;;OAoBG;IACU,gBAAgB,CACzB,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,OAAe,GACvB,OAAO,CAAC,YAAY,CAAC,6BAA6B,CAAC,CAAC;IAuBvD;;;;;;;;;;;;;;;;;OAiBG;IACU,aAAa,CACtB,cAAc,GAAE,OAAe,EAC/B,KAAK,GAAE,OAAe,GACvB,OAAO,CAAC,YAAY,CAAC,0BAA0B,CAAC,CAAC;IAkCpD;;;;;;OAMG;YACW,mBAAmB;IA+DjC;;;OAGG;IACH,IAAW,SAAS,IAAI,kBAAkB,CAEzC;CACJ"}