@remnawave/xtls-sdk 0.0.1 → 0.0.3

package/build/src/common/utils/decode-user/types/decoded-user.type.d.ts

@@ -0,0 +1,18 @@
+import { Account as TrojanAccount } from '../../../../xray-protos/proxy/trojan/config';
+import { Account as VlessAccount } from '../../../../xray-protos/proxy/vless/account';
+import { Account as ShadowsocksAccount } from '../../../../xray-protos/proxy/shadowsocks/config';
+import { Account as Shadowsocks2022Account } from '../../../../xray-protos/proxy/shadowsocks_2022/config';
+import { Account as SocksAccount } from '../../../../xray-protos/proxy/socks/config';
+import { Account as HttpAccount } from '../../../../xray-protos/proxy/http/config';
+export interface DecodedUser {
+    username: string;
+    level: number;
+    protocol: string;
+    trojan?: Omit<TrojanAccount, '$type'>;
+    vless?: Omit<VlessAccount, '$type'>;
+    http?: Omit<HttpAccount, '$type'>;
+    shadowsocks?: Omit<ShadowsocksAccount, '$type'>;
+    shadowsocks2022?: Omit<Shadowsocks2022Account, '$type'>;
+    socks?: Omit<SocksAccount, '$type'>;
+}
+//# sourceMappingURL=decoded-user.type.d.ts.map

package/build/src/common/utils/decode-user/types/decoded-user.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoded-user.type.d.ts","sourceRoot":"","sources":["../../../../../../src/common/utils/decode-user/types/decoded-user.type.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,6CAA6C,CAAC;AACvF,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,6CAA6C,CAAC;AACtF,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,kDAAkD,CAAC;AACjG,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,uDAAuD,CAAC;AAC1G,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,4CAA4C,CAAC;AACrF,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,2CAA2C,CAAC;AAEnF,MAAM,WAAW,WAAW;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACpC,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAClC,WAAW,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;IAChD,eAAe,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC;IACxD,KAAK,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;CACvC"}

package/build/src/common/utils/decode-user/types/decoded-user.type.js

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

package/build/src/common/utils/decode-user/types/index.d.ts

@@ -0,0 +1,4 @@
+export * from './account-type-keys.type';
+export * from './account-type-mapping.type';
+export * from './decoded-user.type';
+//# sourceMappingURL=index.d.ts.map

package/build/src/common/utils/decode-user/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/common/utils/decode-user/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC"}

package/build/src/common/utils/decode-user/types/index.js

@@ -0,0 +1,19 @@
+"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("./account-type-keys.type"), exports);
+__exportStar(require("./account-type-mapping.type"), exports);
+__exportStar(require("./decoded-user.type"), exports);

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

@@ -1 +1,109 @@
+import { Channel } from 'nice-grpc';
+import { ISdkResponse } from '../common/types/sdk-response';
+import { AddUserResponseModel, GetInboundUsersResponseModel } from './models';
+import { IAddHttpUser, IAddShadowsocks2022User, IAddShadowsocksUser, IAddSocksUser, IAddTrojanUser, IAddVlessUser } from './interfaces';
+import { RemoveUserResponseModel } from './models/remove-user/remove-user.response.model';
+/**
+ * Service for managing Xray inbound handlers and their users
+ */
+export declare class HandlerService {
+    private readonly channel;
+    private readonly client;
+    constructor(channel: Channel);
+    /**
+     * Retrieves all users from a specified inbound handler.
+     * This method fetches user information including their credentials and metadata from the Xray server.
+     *
+     * @param {string} tag - The tag identifying the inbound handler to query
+     * @returns {Promise<ISdkResponse<GetInboundUsersResponseModel>>} A promise that resolves to:
+     * - On success: An object with `isOk: true` and `data` containing an array of decoded user information
+     * - On failure: An object with `isOk: false` and error details from HANDLER_ERRORS
+     *
+     * @example
+     * ```typescript
+     * const handler = new HandlerService(channel);
+     * const response = await handler.getInboundUsers('Personal');
+     *
+     * if (response.isOk) {
+     *   console.log(response.data.users); // Array of DecodedUser objects
+     * } else {
+     *   console.error(response.message); // Error message
+     * }
+     * ```
+     */
+    getInboundUsers(tag: string): Promise<ISdkResponse<GetInboundUsersResponseModel>>;
+    /**
+     * Adds a new Trojan user to a specified inbound handler.
+     *
+     * @param {IAddTrojanUser} data - The user data containing tag, username, password and level
+     * @returns {Promise<ISdkResponse<AddUserResponseModel>>} A promise that resolves to:
+     * - On success: An object with `isOk: true` and `data.success` indicating if user was added
+     * - On failure: An object with `isOk: false` and error details from HANDLER_ERRORS
+     */
+    addTrojanUser(data: IAddTrojanUser): Promise<ISdkResponse<AddUserResponseModel>>;
+    /**
+     * Adds a new VLESS user to a specified inbound handler.
+     *
+     * @param {IAddVlessUser} data - The user data containing tag, username, UUID, flow and level
+     * @returns {Promise<ISdkResponse<AddUserResponseModel>>} A promise that resolves to:
+     * - On success: An object with `isOk: true` and `data.success` indicating if user was added
+     * - On failure: An object with `isOk: false` and error details from HANDLER_ERRORS
+     */
+    addVlessUser(data: IAddVlessUser): Promise<ISdkResponse<AddUserResponseModel>>;
+    /**
+     * Adds a new Shadowsocks user to a specified inbound handler.
+     *
+     * @param {IAddShadowsocksUser} data - The user data containing tag, username, password, cipher type, IV check and level
+     * @returns {Promise<ISdkResponse<AddUserResponseModel>>} A promise that resolves to:
+     * - On success: An object with `isOk: true` and `data.success` indicating if user was added
+     * - On failure: An object with `isOk: false` and error details from HANDLER_ERRORS
+     */
+    addShadowsocksUser(data: IAddShadowsocksUser): Promise<ISdkResponse<AddUserResponseModel>>;
+    /**
+     * Adds a new Shadowsocks 2022 user to a specified inbound handler.
+     *
+     * @param {IAddShadowsocks2022User} data - The user data containing tag, username, key and level
+     * @returns {Promise<ISdkResponse<AddUserResponseModel>>} A promise that resolves to:
+     * - On success: An object with `isOk: true` and `data.success` indicating if user was added
+     * - On failure: An object with `isOk: false` and error details from HANDLER_ERRORS
+     */
+    addShadowsocks2022User(data: IAddShadowsocks2022User): Promise<ISdkResponse<AddUserResponseModel>>;
+    /**
+     * Adds a new SOCKS user to a specified inbound handler.
+     *
+     * @param {IAddSocksUser} data - The user data containing tag, username, SOCKS username, SOCKS password and level
+     * @returns {Promise<ISdkResponse<AddUserResponseModel>>} A promise that resolves to:
+     * - On success: An object with `isOk: true` and `data.success` indicating if user was added
+     * - On failure: An object with `isOk: false` and error details from HANDLER_ERRORS
+     */
+    addSocksUser(data: IAddSocksUser): Promise<ISdkResponse<AddUserResponseModel>>;
+    /**
+     * Adds a new HTTP user to a specified inbound handler.
+     *
+     * @param {IAddHttpUser} data - The user data containing tag, username, HTTP username, HTTP password and level
+     * @returns {Promise<ISdkResponse<AddUserResponseModel>>} A promise that resolves to:
+     * - On success: An object with `isOk: true` and `data.success` indicating if user was added
+     * - On failure: An object with `isOk: false` and error details from HANDLER_ERRORS
+     */
+    addHttpUser(data: IAddHttpUser): Promise<ISdkResponse<AddUserResponseModel>>;
+    /**
+     * Removes a user from a specified inbound handler.
+     *
+     * @param {string} tag - The tag identifying the inbound handler
+     * @param {string} username - The username/email of the user to remove
+     * @returns {Promise<ISdkResponse<RemoveUserResponseModel>>} A promise that resolves to:
+     * - On success: An object with `isOk: true` and `data.success` indicating if user was removed
+     * - On failure: An object with `isOk: false` and error details from HANDLER_ERRORS
+     */
+    removeUser(tag: string, username: string): Promise<ISdkResponse<RemoveUserResponseModel>>;
+    /**
+     * Gets the count of users in a specified inbound handler.
+     *
+     * @param {string} tag - The tag identifying the inbound handler
+     * @returns {Promise<ISdkResponse<number>>} A promise that resolves to:
+     * - On success: An object with `isOk: true` and `data` containing the user count
+     * - On failure: An object with `isOk: false` and error details from HANDLER_ERRORS
+     */
+    getInboundUsersCount(tag: string): Promise<ISdkResponse<number>>;
+}
 //# sourceMappingURL=handler.service.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"handler.service.d.ts","sourceRoot":"","sources":["../../../src/handler/handler.service.ts"],"names":[],"mappings":""}
+{"version":3,"file":"handler.service.d.ts","sourceRoot":"","sources":["../../../src/handler/handler.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,OAAO,EAAE,MAAM,WAAW,CAAC;AASlD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,OAAO,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAC;AAC9E,OAAO,EACH,YAAY,EACZ,uBAAuB,EACvB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,aAAa,EAChB,MAAM,cAAc,CAAC;AAOtB,OAAO,EAAE,uBAAuB,EAAE,MAAM,iDAAiD,CAAC;AAE1F;;GAEG;AACH,qBAAa,cAAc;IAGX,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;gBAEjB,OAAO,EAAE,OAAO;IAI7C;;;;;;;;;;;;;;;;;;;;OAoBG;IACU,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,4BAA4B,CAAC,CAAC;IAoB9F;;;;;;;OAOG;IACU,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC;IAuC7F;;;;;;;OAOG;IACU,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC;IAyC3F;;;;;;;OAOG;IACU,kBAAkB,CAC3B,IAAI,EAAE,mBAAmB,GAC1B,OAAO,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC;IAyC9C;;;;;;;OAOG;IACU,sBAAsB,CAC/B,IAAI,EAAE,uBAAuB,GAC9B,OAAO,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC;IAuC9C;;;;;;;OAOG;IACU,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC;IAwC3F;;;;;;;OAOG;IACU,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC;IAwCzF;;;;;;;;OAQG;IACU,UAAU,CACnB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,CAAC,uBAAuB,CAAC,CAAC;IA+BjD;;;;;;;OAOG;IACU,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;CAkBhF"}

package/build/src/handler/handler.service.js

@@ -1 +1,403 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HandlerService = void 0;
+const nice_grpc_1 = require("nice-grpc");
+const command_1 = require("../xray-protos/app/proxyman/command/command");
+const user_1 = require("../xray-protos/common/protocol/user");
+const create_typed_message_1 = __importDefault(require("../common/utils/create-typed-message/create-typed-message"));
+const errors_1 = require("../common/errors");
+const models_1 = require("./models");
+const config_1 = require("../xray-protos/proxy/trojan/config");
+const account_1 = require("../xray-protos/proxy/vless/account");
+const config_2 = require("../xray-protos/proxy/shadowsocks/config");
+const config_3 = require("../xray-protos/proxy/shadowsocks_2022/config");
+const config_4 = require("../xray-protos/proxy/socks/config");
+const config_5 = require("../xray-protos/proxy/http/config");
+const remove_user_response_model_1 = require("./models/remove-user/remove-user.response.model");
+/**
+ * Service for managing Xray inbound handlers and their users
+ */
+class HandlerService {
+    constructor(channel) {
+        this.channel = channel;
+        this.client = (0, nice_grpc_1.createClient)(command_1.HandlerServiceDefinition, channel);
+    }
+    /**
+     * Retrieves all users from a specified inbound handler.
+     * This method fetches user information including their credentials and metadata from the Xray server.
+     *
+     * @param {string} tag - The tag identifying the inbound handler to query
+     * @returns {Promise<ISdkResponse<GetInboundUsersResponseModel>>} A promise that resolves to:
+     * - On success: An object with `isOk: true` and `data` containing an array of decoded user information
+     * - On failure: An object with `isOk: false` and error details from HANDLER_ERRORS
+     *
+     * @example
+     * ```typescript
+     * const handler = new HandlerService(channel);
+     * const response = await handler.getInboundUsers('Personal');
+     *
+     * if (response.isOk) {
+     *   console.log(response.data.users); // Array of DecodedUser objects
+     * } else {
+     *   console.error(response.message); // Error message
+     * }
+     * ```
+     */
+    async getInboundUsers(tag) {
+        try {
+            const response = await this.client.getInboundUsers({ tag });
+            return {
+                isOk: true,
+                data: new models_1.GetInboundUsersResponseModel(response.users),
+            };
+        }
+        catch (error) {
+            let message = '';
+            if (error instanceof Error) {
+                message = error.message;
+            }
+            return {
+                isOk: false,
+                ...errors_1.HANDLER_ERRORS.GET_ALL_USERS_ERROR(message),
+            };
+        }
+    }
+    /**
+     * Adds a new Trojan user to a specified inbound handler.
+     *
+     * @param {IAddTrojanUser} data - The user data containing tag, username, password and level
+     * @returns {Promise<ISdkResponse<AddUserResponseModel>>} A promise that resolves to:
+     * - On success: An object with `isOk: true` and `data.success` indicating if user was added
+     * - On failure: An object with `isOk: false` and error details from HANDLER_ERRORS
+     */
+    async addTrojanUser(data) {
+        try {
+            const response = await this.client.alterInbound({
+                tag: data.tag,
+                operation: (0, create_typed_message_1.default)(command_1.AddUserOperation, {
+                    user: user_1.User.create({
+                        email: data.username,
+                        level: data.level,
+                        account: (0, create_typed_message_1.default)(config_1.Account, {
+                            password: data.password,
+                        }),
+                    }),
+                }),
+            });
+            return {
+                isOk: true,
+                data: new models_1.AddUserResponseModel(true),
+            };
+        }
+        catch (error) {
+            let message = '';
+            if (error instanceof Error) {
+                message = error.message;
+            }
+            if (message.includes('already exists')) {
+                return {
+                    isOk: true,
+                    data: new models_1.AddUserResponseModel(false),
+                };
+            }
+            return {
+                isOk: false,
+                ...errors_1.HANDLER_ERRORS.ADD_USER_ERROR(message),
+            };
+        }
+    }
+    /**
+     * Adds a new VLESS user to a specified inbound handler.
+     *
+     * @param {IAddVlessUser} data - The user data containing tag, username, UUID, flow and level
+     * @returns {Promise<ISdkResponse<AddUserResponseModel>>} A promise that resolves to:
+     * - On success: An object with `isOk: true` and `data.success` indicating if user was added
+     * - On failure: An object with `isOk: false` and error details from HANDLER_ERRORS
+     */
+    async addVlessUser(data) {
+        try {
+            const response = await this.client.alterInbound({
+                tag: data.tag,
+                operation: (0, create_typed_message_1.default)(command_1.AddUserOperation, {
+                    user: user_1.User.create({
+                        email: data.username,
+                        level: data.level,
+                        account: (0, create_typed_message_1.default)(account_1.Account, {
+                            id: data.uuid,
+                            flow: data.flow,
+                            encryption: 'none',
+                        }),
+                    }),
+                }),
+            });
+            return {
+                isOk: true,
+                data: new models_1.AddUserResponseModel(true),
+            };
+        }
+        catch (error) {
+            let message = '';
+            if (error instanceof Error) {
+                message = error.message;
+            }
+            if (message.includes('already exists')) {
+                return {
+                    isOk: true,
+                    data: new models_1.AddUserResponseModel(false),
+                };
+            }
+            return {
+                isOk: false,
+                ...errors_1.HANDLER_ERRORS.ADD_USER_ERROR(message),
+            };
+        }
+    }
+    /**
+     * Adds a new Shadowsocks user to a specified inbound handler.
+     *
+     * @param {IAddShadowsocksUser} data - The user data containing tag, username, password, cipher type, IV check and level
+     * @returns {Promise<ISdkResponse<AddUserResponseModel>>} A promise that resolves to:
+     * - On success: An object with `isOk: true` and `data.success` indicating if user was added
+     * - On failure: An object with `isOk: false` and error details from HANDLER_ERRORS
+     */
+    async addShadowsocksUser(data) {
+        try {
+            const response = await this.client.alterInbound({
+                tag: data.tag,
+                operation: (0, create_typed_message_1.default)(command_1.AddUserOperation, {
+                    user: user_1.User.create({
+                        email: data.username,
+                        level: data.level,
+                        account: (0, create_typed_message_1.default)(config_2.Account, {
+                            password: data.password,
+                            cipherType: data.cipherType,
+                            ivCheck: data.ivCheck,
+                        }),
+                    }),
+                }),
+            });
+            return {
+                isOk: true,
+                data: new models_1.AddUserResponseModel(true),
+            };
+        }
+        catch (error) {
+            let message = '';
+            if (error instanceof Error) {
+                message = error.message;
+            }
+            if (message.includes('already exists')) {
+                return {
+                    isOk: true,
+                    data: new models_1.AddUserResponseModel(false),
+                };
+            }
+            return {
+                isOk: false,
+                ...errors_1.HANDLER_ERRORS.ADD_USER_ERROR(message),
+            };
+        }
+    }
+    /**
+     * Adds a new Shadowsocks 2022 user to a specified inbound handler.
+     *
+     * @param {IAddShadowsocks2022User} data - The user data containing tag, username, key and level
+     * @returns {Promise<ISdkResponse<AddUserResponseModel>>} A promise that resolves to:
+     * - On success: An object with `isOk: true` and `data.success` indicating if user was added
+     * - On failure: An object with `isOk: false` and error details from HANDLER_ERRORS
+     */
+    async addShadowsocks2022User(data) {
+        try {
+            const response = await this.client.alterInbound({
+                tag: data.tag,
+                operation: (0, create_typed_message_1.default)(command_1.AddUserOperation, {
+                    user: user_1.User.create({
+                        email: data.username,
+                        level: data.level,
+                        account: (0, create_typed_message_1.default)(config_3.Account, {
+                            key: data.key,
+                        }),
+                    }),
+                }),
+            });
+            return {
+                isOk: true,
+                data: new models_1.AddUserResponseModel(true),
+            };
+        }
+        catch (error) {
+            let message = '';
+            if (error instanceof Error) {
+                message = error.message;
+            }
+            if (message.includes('already exists')) {
+                return {
+                    isOk: true,
+                    data: new models_1.AddUserResponseModel(false),
+                };
+            }
+            return {
+                isOk: false,
+                ...errors_1.HANDLER_ERRORS.ADD_USER_ERROR(message),
+            };
+        }
+    }
+    /**
+     * Adds a new SOCKS user to a specified inbound handler.
+     *
+     * @param {IAddSocksUser} data - The user data containing tag, username, SOCKS username, SOCKS password and level
+     * @returns {Promise<ISdkResponse<AddUserResponseModel>>} A promise that resolves to:
+     * - On success: An object with `isOk: true` and `data.success` indicating if user was added
+     * - On failure: An object with `isOk: false` and error details from HANDLER_ERRORS
+     */
+    async addSocksUser(data) {
+        try {
+            const response = await this.client.alterInbound({
+                tag: data.tag,
+                operation: (0, create_typed_message_1.default)(command_1.AddUserOperation, {
+                    user: user_1.User.create({
+                        email: data.username,
+                        level: data.level,
+                        account: (0, create_typed_message_1.default)(config_4.Account, {
+                            username: data.socks_username,
+                            password: data.socks_password,
+                        }),
+                    }),
+                }),
+            });
+            return {
+                isOk: true,
+                data: new models_1.AddUserResponseModel(true),
+            };
+        }
+        catch (error) {
+            let message = '';
+            if (error instanceof Error) {
+                message = error.message;
+            }
+            if (message.includes('already exists')) {
+                return {
+                    isOk: true,
+                    data: new models_1.AddUserResponseModel(false),
+                };
+            }
+            return {
+                isOk: false,
+                ...errors_1.HANDLER_ERRORS.ADD_USER_ERROR(message),
+            };
+        }
+    }
+    /**
+     * Adds a new HTTP user to a specified inbound handler.
+     *
+     * @param {IAddHttpUser} data - The user data containing tag, username, HTTP username, HTTP password and level
+     * @returns {Promise<ISdkResponse<AddUserResponseModel>>} A promise that resolves to:
+     * - On success: An object with `isOk: true` and `data.success` indicating if user was added
+     * - On failure: An object with `isOk: false` and error details from HANDLER_ERRORS
+     */
+    async addHttpUser(data) {
+        try {
+            const response = await this.client.alterInbound({
+                tag: data.tag,
+                operation: (0, create_typed_message_1.default)(command_1.AddUserOperation, {
+                    user: user_1.User.create({
+                        email: data.username,
+                        level: data.level,
+                        account: (0, create_typed_message_1.default)(config_5.Account, {
+                            username: data.http_username,
+                            password: data.http_password,
+                        }),
+                    }),
+                }),
+            });
+            return {
+                isOk: true,
+                data: new models_1.AddUserResponseModel(true),
+            };
+        }
+        catch (error) {
+            let message = '';
+            if (error instanceof Error) {
+                message = error.message;
+            }
+            if (message.includes('already exists')) {
+                return {
+                    isOk: true,
+                    data: new models_1.AddUserResponseModel(false),
+                };
+            }
+            return {
+                isOk: false,
+                ...errors_1.HANDLER_ERRORS.ADD_USER_ERROR(message),
+            };
+        }
+    }
+    /**
+     * Removes a user from a specified inbound handler.
+     *
+     * @param {string} tag - The tag identifying the inbound handler
+     * @param {string} username - The username/email of the user to remove
+     * @returns {Promise<ISdkResponse<RemoveUserResponseModel>>} A promise that resolves to:
+     * - On success: An object with `isOk: true` and `data.success` indicating if user was removed
+     * - On failure: An object with `isOk: false` and error details from HANDLER_ERRORS
+     */
+    async removeUser(tag, username) {
+        try {
+            const response = await this.client.alterInbound({
+                tag: tag,
+                operation: (0, create_typed_message_1.default)(command_1.RemoveUserOperation, { email: username }),
+            });
+            return {
+                isOk: true,
+                data: new remove_user_response_model_1.RemoveUserResponseModel(true),
+            };
+        }
+        catch (error) {
+            let message = '';
+            if (error instanceof Error) {
+                message = error.message;
+            }
+            if (message.includes('not found')) {
+                return {
+                    isOk: true,
+                    data: new remove_user_response_model_1.RemoveUserResponseModel(false),
+                };
+            }
+            return {
+                isOk: false,
+                ...errors_1.HANDLER_ERRORS.REMOVE_USER_ERROR(message),
+            };
+        }
+    }
+    /**
+     * Gets the count of users in a specified inbound handler.
+     *
+     * @param {string} tag - The tag identifying the inbound handler
+     * @returns {Promise<ISdkResponse<number>>} A promise that resolves to:
+     * - On success: An object with `isOk: true` and `data` containing the user count
+     * - On failure: An object with `isOk: false` and error details from HANDLER_ERRORS
+     */
+    async getInboundUsersCount(tag) {
+        try {
+            const response = await this.client.getInboundUsersCount({ tag });
+            return {
+                isOk: true,
+                data: response.count,
+            };
+        }
+        catch (error) {
+            let message = '';
+            if (error instanceof Error) {
+                message = error.message;
+            }
+            return {
+                isOk: false,
+                ...errors_1.HANDLER_ERRORS.GET_INBOUND_USERS_COUNT_ERROR(message),
+            };
+        }
+    }
+}
+exports.HandlerService = HandlerService;

package/build/src/handler/interfaces/add-user/add-http-user.interface.d.ts

@@ -0,0 +1,8 @@
+export interface IAddHttpUser {
+    tag: string;
+    username: string;
+    level: number;
+    http_username: string;
+    http_password: string;
+}
+//# sourceMappingURL=add-http-user.interface.d.ts.map

package/build/src/handler/interfaces/add-user/add-http-user.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-http-user.interface.d.ts","sourceRoot":"","sources":["../../../../../src/handler/interfaces/add-user/add-http-user.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACzB"}

package/build/src/handler/interfaces/add-user/add-http-user.interface.js

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

package/build/src/handler/interfaces/add-user/add-shadowsocks-user.interface.d.ts

@@ -0,0 +1,10 @@
+import { CipherType } from '../../../xray-protos/proxy/shadowsocks/config';
+export interface IAddShadowsocksUser {
+    tag: string;
+    username: string;
+    level: number;
+    password: string;
+    cipherType: CipherType;
+    ivCheck: boolean;
+}
+//# sourceMappingURL=add-shadowsocks-user.interface.d.ts.map

package/build/src/handler/interfaces/add-user/add-shadowsocks-user.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-shadowsocks-user.interface.d.ts","sourceRoot":"","sources":["../../../../../src/handler/interfaces/add-user/add-shadowsocks-user.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,+CAA+C,CAAC;AAE3E,MAAM,WAAW,mBAAmB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;CACpB"}

package/build/src/handler/interfaces/add-user/add-shadowsocks-user.interface.js

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

package/build/src/handler/interfaces/add-user/add-shadowsocks2022-user.interface.d.ts

@@ -0,0 +1,7 @@
+export interface IAddShadowsocks2022User {
+    username: string;
+    level: number;
+    key: string;
+    tag: string;
+}
+//# sourceMappingURL=add-shadowsocks2022-user.interface.d.ts.map

package/build/src/handler/interfaces/add-user/add-shadowsocks2022-user.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-shadowsocks2022-user.interface.d.ts","sourceRoot":"","sources":["../../../../../src/handler/interfaces/add-user/add-shadowsocks2022-user.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACf"}

package/build/src/handler/interfaces/add-user/add-shadowsocks2022-user.interface.js

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

package/build/src/handler/interfaces/add-user/add-socks-user.interface.d.ts

@@ -0,0 +1,8 @@
+export interface IAddSocksUser {
+    username: string;
+    level: number;
+    socks_username: string;
+    socks_password: string;
+    tag: string;
+}
+//# sourceMappingURL=add-socks-user.interface.d.ts.map

package/build/src/handler/interfaces/add-user/add-socks-user.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-socks-user.interface.d.ts","sourceRoot":"","sources":["../../../../../src/handler/interfaces/add-user/add-socks-user.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;CACf"}

package/build/src/handler/interfaces/add-user/add-socks-user.interface.js

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

package/build/src/handler/interfaces/add-user/add-trojan-user.interface.d.ts

@@ -0,0 +1,7 @@
+export interface IAddTrojanUser {
+    username: string;
+    level: number;
+    password: string;
+    tag: string;
+}
+//# sourceMappingURL=add-trojan-user.interface.d.ts.map

package/build/src/handler/interfaces/add-user/add-trojan-user.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-trojan-user.interface.d.ts","sourceRoot":"","sources":["../../../../../src/handler/interfaces/add-user/add-trojan-user.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACf"}