xray-manager 1.0.0

package/dist/utils/validator.js

@@ -0,0 +1,238 @@
+"use strict";
+/**
+ * 输入验证工具函数
+ * @module utils/validator
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validators = void 0;
+exports.isValidEmail = isValidEmail;
+exports.isValidUuid = isValidUuid;
+exports.isValidPort = isValidPort;
+exports.isValidDomain = isValidDomain;
+exports.isValidServiceName = isValidServiceName;
+exports.isValidIPv4 = isValidIPv4;
+exports.isValidPath = isValidPath;
+exports.isValidUrl = isValidUrl;
+exports.validate = validate;
+exports.validateMultiple = validateMultiple;
+exports.allValid = allValid;
+exports.getErrors = getErrors;
+/**
+ * 邮箱验证正则表达式
+ */
+const EMAIL_REGEX = /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/;
+/**
+ * UUID v4 验证正则表达式
+ */
+const UUID_V4_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+/**
+ * 端口号验证正则表达式（1-65535）
+ */
+const _PORT_REGEX = /^([1-9][0-9]{0,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5])$/;
+/**
+ * 域名验证正则表达式
+ */
+const DOMAIN_REGEX = /^([a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\.)+[a-zA-Z]{2,}$/;
+/**
+ * 服务名验证正则表达式（仅字母数字、@、._-）
+ */
+const SERVICE_NAME_REGEX = /^[a-zA-Z0-9@._-]+$/;
+/**
+ * IPv4 地址验证正则表达式
+ */
+const IPV4_REGEX = /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/;
+/**
+ * 路径验证正则表达式（Unix 路径）
+ */
+const PATH_REGEX = /^\/(?:[^/\0]+\/)*[^/\0]*$/;
+/**
+ * 验证邮箱地址
+ * @param email 邮箱地址
+ * @returns 是否有效
+ */
+function isValidEmail(email) {
+    if (!email || typeof email !== 'string') {
+        return false;
+    }
+    return EMAIL_REGEX.test(email);
+}
+/**
+ * 验证 UUID v4 格式
+ * @param uuid UUID 字符串
+ * @returns 是否有效
+ */
+function isValidUuid(uuid) {
+    if (!uuid || typeof uuid !== 'string') {
+        return false;
+    }
+    return UUID_V4_REGEX.test(uuid);
+}
+/**
+ * 验证端口号（1-65535）
+ * @param port 端口号（数字或字符串）
+ * @returns 是否有效
+ */
+function isValidPort(port) {
+    const num = typeof port === 'string' ? parseInt(port, 10) : port;
+    if (isNaN(num) || !Number.isInteger(num)) {
+        return false;
+    }
+    return num >= 1 && num <= 65535;
+}
+/**
+ * 验证域名
+ * @param domain 域名
+ * @returns 是否有效
+ */
+function isValidDomain(domain) {
+    if (!domain || typeof domain !== 'string') {
+        return false;
+    }
+    return DOMAIN_REGEX.test(domain);
+}
+/**
+ * 验证服务名称
+ * @param serviceName 服务名称
+ * @returns 是否有效
+ */
+function isValidServiceName(serviceName) {
+    if (!serviceName || typeof serviceName !== 'string') {
+        return false;
+    }
+    return SERVICE_NAME_REGEX.test(serviceName);
+}
+/**
+ * 验证 IPv4 地址
+ * @param ip IP 地址
+ * @returns 是否有效
+ */
+function isValidIPv4(ip) {
+    if (!ip || typeof ip !== 'string') {
+        return false;
+    }
+    return IPV4_REGEX.test(ip);
+}
+/**
+ * 验证 Unix 路径
+ * @param path 路径字符串
+ * @returns 是否有效
+ */
+function isValidPath(path) {
+    if (!path || typeof path !== 'string') {
+        return false;
+    }
+    return PATH_REGEX.test(path);
+}
+/**
+ * 验证 URL
+ * @param url URL 字符串
+ * @returns 是否有效
+ */
+function isValidUrl(url) {
+    try {
+        new URL(url);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 验证器映射
+ */
+exports.validators = {
+    email: {
+        validate: isValidEmail,
+        errorMessage: '请输入有效的邮箱地址（如 user@example.com）',
+    },
+    uuid: {
+        validate: isValidUuid,
+        errorMessage: '请输入有效的 UUID v4 格式',
+    },
+    port: {
+        validate: (value) => {
+            const num = parseInt(value, 10);
+            return !isNaN(num) && isValidPort(num);
+        },
+        errorMessage: '端口号必须在 1-65535 之间',
+    },
+    domain: {
+        validate: isValidDomain,
+        errorMessage: '请输入有效的域名（如 example.com）',
+    },
+    serviceName: {
+        validate: isValidServiceName,
+        errorMessage: '服务名只能包含字母、数字和 @._- 字符',
+    },
+    ipv4: {
+        validate: isValidIPv4,
+        errorMessage: '请输入有效的 IPv4 地址',
+    },
+    path: {
+        validate: isValidPath,
+        errorMessage: '请输入有效的 Unix 路径（以 / 开头）',
+    },
+    url: {
+        validate: isValidUrl,
+        errorMessage: '请输入有效的 URL',
+    },
+};
+/**
+ * 通用验证函数
+ * @param value 待验证的值
+ * @param validatorName 验证器名称
+ * @param fieldName 字段名称（用于错误消息）
+ * @returns 验证结果
+ */
+function validate(value, validatorName, fieldName) {
+    const validator = exports.validators[validatorName];
+    if (!validator) {
+        return {
+            valid: false,
+            error: `未知的验证器: ${validatorName}`,
+            field: fieldName,
+        };
+    }
+    const valid = validator.validate(value);
+    if (!valid) {
+        return {
+            valid: false,
+            error: validator.errorMessage,
+            field: fieldName,
+        };
+    }
+    return { valid: true };
+}
+/**
+ * 批量验证
+ * @param values 字段和值的映射
+ * @param validatorMap 字段和验证器的映射
+ * @returns 验证结果列表
+ */
+function validateMultiple(values, validatorMap) {
+    const results = [];
+    for (const [field, value] of Object.entries(values)) {
+        const validatorName = validatorMap[field];
+        if (validatorName) {
+            results.push(validate(value, validatorName, field));
+        }
+    }
+    return results;
+}
+/**
+ * 检查所有验证是否通过
+ * @param results 验证结果列表
+ * @returns 是否全部通过
+ */
+function allValid(results) {
+    return results.every((result) => result.valid);
+}
+/**
+ * 获取所有错误消息
+ * @param results 验证结果列表
+ * @returns 错误消息列表
+ */
+function getErrors(results) {
+    return results.filter((result) => !result.valid).map((result) => result.error || '未知错误');
+}
+//# sourceMappingURL=validator.js.map

package/dist/utils/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/utils/validator.ts"],"names":[],"mappings":"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"}

package/dist/utils/which.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Which utility - Find executable in PATH
+ *
+ * @module utils/which
+ */
+/**
+ * Find executable in PATH
+ *
+ * @param command - Command name to find
+ * @returns Path to executable or null if not found
+ */
+export declare function which(command: string): string | null;
+//# sourceMappingURL=which.d.ts.map

package/dist/utils/which.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"which.d.ts","sourceRoot":"","sources":["../../src/utils/which.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWpD"}

package/dist/utils/which.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Which utility - Find executable in PATH
+ *
+ * @module utils/which
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.which = which;
+const child_process_1 = require("child_process");
+/**
+ * Find executable in PATH
+ *
+ * @param command - Command name to find
+ * @returns Path to executable or null if not found
+ */
+function which(command) {
+    try {
+        const result = (0, child_process_1.execSync)(`which ${command}`, {
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        return result.trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=which.js.map

package/dist/utils/which.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"which.js","sourceRoot":"","sources":["../../src/utils/which.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAUH,sBAWC;AAnBD,iDAAyC;AAEzC;;;;;GAKG;AACH,SAAgB,KAAK,CAAC,OAAe;IACnC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,wBAAQ,EAAC,SAAS,OAAO,EAAE,EAAE;YAC1C,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "xray-manager",
+  "version": "1.0.0",
+  "description": "Xray VPN 服务管理 CLI 工具 - npm installable interactive CLI tool for Xray service management",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "xray-manager": "./dist/cli.js",
+    "xm": "./dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:ui": "vitest --ui",
+    "lint": "eslint src tests --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "xray",
+    "vpn",
+    "cli",
+    "systemd",
+    "interactive",
+    "service-management",
+    "vless",
+    "reality",
+    "proxy",
+    "server-management"
+  ],
+  "author": "DanOps-1",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/DanOps-1/Xray-VPN-OneClick.git"
+  },
+  "bugs": {
+    "url": "https://github.com/DanOps-1/Xray-VPN-OneClick/issues"
+  },
+  "homepage": "https://github.com/DanOps-1/Xray-VPN-OneClick#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.1.0",
+    "chalk": "^4.1.2",
+    "clipboardy": "^5.0.2",
+    "commander": "^14.0.2",
+    "ora": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "@typescript-eslint/eslint-plugin": "^8.52.0",
+    "@typescript-eslint/parser": "^8.52.0",
+    "@vitest/coverage-v8": "^4.0.16",
+    "@vitest/ui": "^4.0.16",
+    "c8": "^10.1.3",
+    "eslint": "^9.39.2",
+    "prettier": "^3.7.4",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.16"
+  }
+}