@remnawave/xtls-sdk 0.0.1 → 0.0.2

package/build/src/common/errors/handler/handler.errors.d.ts

@@ -0,0 +1,23 @@
+export declare const HANDLER_ERRORS: {
+    readonly UNKNOWN_ERROR: {
+        readonly code: "A001";
+        readonly message: "Unexpected error";
+    };
+    readonly GET_ALL_USERS_ERROR: (message: string) => {
+        code: string;
+        message: string;
+    };
+    readonly ADD_USER_ERROR: (message: string) => {
+        code: string;
+        message: string;
+    };
+    readonly REMOVE_USER_ERROR: (message: string) => {
+        code: string;
+        message: string;
+    };
+    readonly GET_INBOUND_USERS_COUNT_ERROR: (message: string) => {
+        code: string;
+        message: string;
+    };
+};
+//# sourceMappingURL=handler.errors.d.ts.map

package/build/src/common/errors/handler/handler.errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.errors.d.ts","sourceRoot":"","sources":["../../../../../src/common/errors/handler/handler.errors.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc;;;;;4CAEQ,MAAM;;;;uCAIX,MAAM;;;;0CAIH,MAAM;;;;sDAIM,MAAM;;;;CAIzC,CAAC"}

package/build/src/common/errors/handler/handler.errors.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HANDLER_ERRORS = void 0;
+exports.HANDLER_ERRORS = {
+    UNKNOWN_ERROR: { code: 'A001', message: 'Unexpected error' },
+    GET_ALL_USERS_ERROR: (message) => ({
+        code: 'A002',
+        message: `Error getting all users: ${message}`,
+    }),
+    ADD_USER_ERROR: (message) => ({
+        code: 'A003',
+        message: `Error adding user: ${message}`,
+    }),
+    REMOVE_USER_ERROR: (message) => ({
+        code: 'A004',
+        message: `Error removing user: ${message}`,
+    }),
+    GET_INBOUND_USERS_COUNT_ERROR: (message) => ({
+        code: 'A005',
+        message: `Error getting inbound users count: ${message}`,
+    }),
+};

package/build/src/common/errors/handler/index.d.ts

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

package/build/src/common/errors/handler/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/common/errors/handler/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/build/src/common/errors/handler/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("./handler.errors"), exports);

package/build/src/common/errors/index.d.ts

@@ -1,2 +1,3 @@
 export * from './stats';
+export * from './handler';
 //# sourceMappingURL=index.d.ts.map

package/build/src/common/errors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/common/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/common/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC"}

package/build/src/common/errors/index.js

@@ -15,3 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./stats"), exports);
+__exportStar(require("./handler"), exports);

package/build/src/common/utils/create-typed-message/create-typed-message.d.ts

@@ -0,0 +1,5 @@
+import { TypedMessage } from '../../../xray-protos/common/serial/typed_message';
+import { MessageFns } from '../../../xray-protos/common/serial/typed_message';
+declare function createTypedMessage<T extends MessageFns<unknown, string>>(proto: T, data: Parameters<T['create']>[0]): TypedMessage;
+export default createTypedMessage;
+//# sourceMappingURL=create-typed-message.d.ts.map

package/build/src/common/utils/create-typed-message/create-typed-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-typed-message.d.ts","sourceRoot":"","sources":["../../../../../src/common/utils/create-typed-message/create-typed-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kDAAkD,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,kDAAkD,CAAC;AAE9E,iBAAS,kBAAkB,CAAC,CAAC,SAAS,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,EAC7D,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GACjC,YAAY,CAKd;AAED,eAAe,kBAAkB,CAAC"}

package/build/src/common/utils/create-typed-message/create-typed-message.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const typed_message_1 = require("../../../xray-protos/common/serial/typed_message");
+function createTypedMessage(proto, data) {
+    return typed_message_1.TypedMessage.create({
+        type: proto.$type,
+        value: proto.encode(proto.create(data)).finish(),
+    });
+}
+exports.default = createTypedMessage;

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

@@ -0,0 +1,39 @@
+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 declare const ACCOUNT_TYPES: {
+    readonly "xray.proxy.trojan.Account": {
+        readonly decoder: import("../../../../xray-protos/proxy/trojan/config").MessageFns<TrojanAccount, "xray.proxy.trojan.Account">;
+        readonly protocol: "trojan";
+        readonly getCredentials: (acc: TrojanAccount) => Omit<TrojanAccount, "$type">;
+    };
+    readonly "xray.proxy.vless.Account": {
+        readonly decoder: import("../../../../xray-protos/proxy/vless/account").MessageFns<VlessAccount, "xray.proxy.vless.Account">;
+        readonly protocol: "vless";
+        readonly getCredentials: (acc: VlessAccount) => Omit<VlessAccount, "$type">;
+    };
+    readonly "xray.proxy.shadowsocks.Account": {
+        readonly decoder: import("../../../../xray-protos/proxy/shadowsocks/config").MessageFns<ShadowsocksAccount, "xray.proxy.shadowsocks.Account">;
+        readonly protocol: "shadowsocks";
+        readonly getCredentials: (acc: ShadowsocksAccount) => Omit<ShadowsocksAccount, "$type">;
+    };
+    readonly "xray.proxy.shadowsocks_2022.Account": {
+        readonly decoder: import("../../../../xray-protos/proxy/shadowsocks_2022/config").MessageFns<Shadowsocks2022Account, "xray.proxy.shadowsocks_2022.Account">;
+        readonly protocol: "shadowsocks2022";
+        readonly getCredentials: (acc: Shadowsocks2022Account) => Omit<Shadowsocks2022Account, "$type">;
+    };
+    readonly "xray.proxy.socks.Account": {
+        readonly decoder: import("../../../../xray-protos/proxy/socks/config").MessageFns<SocksAccount, "xray.proxy.socks.Account">;
+        readonly protocol: "socks";
+        readonly getCredentials: (acc: SocksAccount) => Omit<SocksAccount, "$type">;
+    };
+    readonly "xray.proxy.http.Account": {
+        readonly decoder: import("../../../../xray-protos/proxy/http/config").MessageFns<HttpAccount, "xray.proxy.http.Account">;
+        readonly protocol: "http";
+        readonly getCredentials: (acc: HttpAccount) => Omit<HttpAccount, "$type">;
+    };
+};
+//# sourceMappingURL=account-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"account-types.d.ts","sourceRoot":"","sources":["../../../../../../src/common/utils/decode-user/constants/account-types.ts"],"names":[],"mappings":"AAAA,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,eAAO,MAAM,aAAa;;;;uCAII,aAAa,KAAG,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC;;;;;uCAO5C,YAAY,KAAG,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC;;;;;uCAS1C,kBAAkB,KAAG,IAAI,CAAC,kBAAkB,EAAE,OAAO,CAAC;;;;;uCAStD,sBAAsB,KAAG,IAAI,CAAC,sBAAsB,EAAE,OAAO,CAAC;;;;;uCAO9D,YAAY,KAAG,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC;;;;;uCAQ1C,WAAW,KAAG,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC;;CAK5D,CAAC"}

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

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ACCOUNT_TYPES = void 0;
+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");
+exports.ACCOUNT_TYPES = {
+    [config_1.Account.$type]: {
+        decoder: config_1.Account,
+        protocol: 'trojan',
+        getCredentials: (acc) => ({
+            password: acc.password,
+        }),
+    },
+    [account_1.Account.$type]: {
+        decoder: account_1.Account,
+        protocol: 'vless',
+        getCredentials: (acc) => ({
+            id: acc.id,
+            flow: acc.flow,
+            encryption: acc.encryption,
+        }),
+    },
+    [config_2.Account.$type]: {
+        decoder: config_2.Account,
+        protocol: 'shadowsocks',
+        getCredentials: (acc) => ({
+            password: acc.password,
+            cipherType: acc.cipherType,
+            ivCheck: acc.ivCheck,
+        }),
+    },
+    [config_3.Account.$type]: {
+        decoder: config_3.Account,
+        protocol: 'shadowsocks2022',
+        getCredentials: (acc) => ({
+            key: acc.key,
+        }),
+    },
+    [config_4.Account.$type]: {
+        decoder: config_4.Account,
+        protocol: 'socks',
+        getCredentials: (acc) => ({
+            username: acc.username,
+            password: acc.password,
+        }),
+    },
+    [config_5.Account.$type]: {
+        decoder: config_5.Account,
+        protocol: 'http',
+        getCredentials: (acc) => ({
+            username: acc.username,
+            password: acc.password,
+        }),
+    },
+};

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/common/utils/decode-user/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/build/src/common/utils/decode-user/constants/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("./account-types"), exports);

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

@@ -0,0 +1,37 @@
+import { User } from '../../../xray-protos/common/protocol/user';
+import { DecodedUser } from './types';
+/**
+ * Decodes a User object into a DecodedUser with credentials and metadata.
+ * The function extracts account credentials based on the account type and protocol.
+ *
+ * @param user - The User object to decode, containing account information including:
+ *   - email: User's email address used as username
+ *   - level: User's permission level
+ *   - account: Object containing account type and encoded credentials
+ * @returns DecodedUser object containing:
+ *   - Protocol-specific credentials decoded from the account value
+ *   - Protocol identifier
+ *   - Username (from email)
+ *   - Permission level
+ * @throws Error if user object is missing account information
+ * @throws Error if account type is not recognized
+ *
+ * @example
+ * const user = {
+ *   email: "user@example.com",
+ *   level: 1,
+ *   account: {
+ *     type: "standard",
+ *     value: Buffer.from("...") // Encoded credentials
+ *   }
+ * };
+ * const decoded = decodeUser(user);
+ * // Returns: {
+ * //   standard: { ... decoded credentials ... },
+ * //   protocol: "standard",
+ * //   username: "user@example.com",
+ * //   level: 1
+ * // }
+ */
+export declare const decodeUser: (user: User) => DecodedUser;
+//# sourceMappingURL=decode-user.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decode-user.d.ts","sourceRoot":"","sources":["../../../../../src/common/utils/decode-user/decode-user.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,2CAA2C,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,UAAU,SAAU,IAAI,KAAG,WAoBvC,CAAC"}

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

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeUser = void 0;
+const constants_1 = require("./constants");
+/**
+ * Decodes a User object into a DecodedUser with credentials and metadata.
+ * The function extracts account credentials based on the account type and protocol.
+ *
+ * @param user - The User object to decode, containing account information including:
+ *   - email: User's email address used as username
+ *   - level: User's permission level
+ *   - account: Object containing account type and encoded credentials
+ * @returns DecodedUser object containing:
+ *   - Protocol-specific credentials decoded from the account value
+ *   - Protocol identifier
+ *   - Username (from email)
+ *   - Permission level
+ * @throws Error if user object is missing account information
+ * @throws Error if account type is not recognized
+ *
+ * @example
+ * const user = {
+ *   email: "user@example.com",
+ *   level: 1,
+ *   account: {
+ *     type: "standard",
+ *     value: Buffer.from("...") // Encoded credentials
+ *   }
+ * };
+ * const decoded = decodeUser(user);
+ * // Returns: {
+ * //   standard: { ... decoded credentials ... },
+ * //   protocol: "standard",
+ * //   username: "user@example.com",
+ * //   level: 1
+ * // }
+ */
+const decodeUser = (user) => {
+    if (!user?.account) {
+        throw new Error('Invalid user object: missing account');
+    }
+    const accountType = user.account.type;
+    const accountConfig = constants_1.ACCOUNT_TYPES[accountType];
+    if (!accountConfig) {
+        throw new Error(`Unknown account type: ${accountType}`);
+    }
+    const accountBuffer = Buffer.from(user.account.value);
+    const decodedAccount = accountConfig.decoder.decode(accountBuffer);
+    return {
+        [accountConfig.protocol]: accountConfig.getCredentials(decodedAccount),
+        protocol: accountConfig.protocol,
+        username: user.email,
+        level: user.level,
+    };
+};
+exports.decodeUser = decodeUser;

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

@@ -0,0 +1,3 @@
+import { ACCOUNT_TYPES } from '../constants';
+export type TAccountTypesKey = keyof typeof ACCOUNT_TYPES;
+//# sourceMappingURL=account-type-keys.type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"account-type-keys.type.d.ts","sourceRoot":"","sources":["../../../../../../src/common/utils/decode-user/types/account-type-keys.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,aAAa,CAAC"}

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

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

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

@@ -0,0 +1,4 @@
+import { ACCOUNT_TYPES } from '../constants';
+import { TAccountTypesKey } from './account-type-keys.type';
+export type AccountTypeMapping = ReturnType<(typeof ACCOUNT_TYPES)[TAccountTypesKey]['getCredentials']>;
+//# sourceMappingURL=account-type-mapping.type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"account-type-mapping.type.d.ts","sourceRoot":"","sources":["../../../../../../src/common/utils/decode-user/types/account-type-mapping.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,MAAM,MAAM,kBAAkB,GAAG,UAAU,CACvC,CAAC,OAAO,aAAa,CAAC,CAAC,gBAAgB,CAAC,CAAC,gBAAgB,CAAC,CAC7D,CAAC"}

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

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

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"}