@remnawave/xtls-sdk 0.0.1

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,EAAQ,MAAM,gDAAgD,CAAC;AAC1F,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;CAyBpB"}

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 formattedStats = data.stat.reduce((acc, curr) => {
+            const nameParts = curr.name.split('>>>');
+            const username = nameParts[1];
+            const type = nameParts[3];
+            const value = curr.value;
+            let user = acc.find((item) => item.username === username);
+            if (!user) {
+                user = { username, uplink: 0, downlink: 0 };
+                acc.push(user);
+            }
+            if (type === 'uplink') {
+                user.uplink += value;
+            }
+            else if (type === 'downlink') {
+                user.downlink += value;
+            }
+            return acc;
+        }, []);
+        return formattedStats;
+    }
+}
+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/index.d.ts

@@ -0,0 +1,9 @@
+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';
+//# 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"}

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

@@ -0,0 +1,24 @@
+"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);

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

@@ -0,0 +1,227 @@
+import { Channel } from 'nice-grpc';
+import { ISdkResponse } from '../common/types';
+import { GetAllUsersStatsResponseModel, GetUserStatsResponseModel, GetSysStatsResponseModel, GetUserOnlineStatusResponseModel, GetAllInboundsStatsResponseModel, GetInboundStatsResponseModel, GetAllOutboundsStatsResponseModel, GetOutboundStatsResponseModel } from './models';
+/**
+ * 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;
+    /**
+     * 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>>;
+}
+//# 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,EAAgB,MAAM,WAAW,CAAC;AAKlD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EACH,6BAA6B,EAC7B,yBAAyB,EACzB,wBAAwB,EACxB,gCAAgC,EAChC,gCAAgC,EAChC,4BAA4B,EAC5B,iCAAiC,EACjC,6BAA6B,EAChC,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,YAAY;IAWT,OAAO,CAAC,QAAQ,CAAC,OAAO;IAVpC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAE5C;;;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;CAsB1D"}