xray-manager 1.0.0

package/dist/constants/exit-codes.js

@@ -0,0 +1,100 @@
+"use strict";
+/**
+ * 标准化退出代码
+ * @module constants/exit-codes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExitCodeDescription = exports.ExitCode = void 0;
+exports.getExitCodeForError = getExitCodeForError;
+exports.gracefulExit = gracefulExit;
+/**
+ * CLI 工具退出代码常量
+ * 遵循 Unix/Linux 退出代码规范
+ */
+exports.ExitCode = {
+    /** 成功 */
+    SUCCESS: 0,
+    /** 通用错误 */
+    GENERAL_ERROR: 1,
+    /** 参数错误 - 无效的命令行参数或选项 */
+    INVALID_ARGUMENT: 2,
+    /** 配置错误 - 配置文件错误、缺失或无法解析 */
+    CONFIG_ERROR: 3,
+    /** 权限错误 - 需要 root/sudo 权限但未提供 */
+    PERMISSION_ERROR: 4,
+    /** 服务错误 - systemd 服务操作失败 */
+    SERVICE_ERROR: 5,
+    /** 网络错误 - 网络连接失败或超时 */
+    NETWORK_ERROR: 6,
+    /** 文件错误 - 文件读写操作失败 */
+    FILE_ERROR: 7,
+    /** 验证错误 - 输入验证失败（邮箱、UUID 等） */
+    VALIDATION_ERROR: 8,
+    /** 未找到 - 资源不存在（用户、服务等） */
+    NOT_FOUND: 9,
+    /** 用户中断 - Ctrl+C 中断程序执行 */
+    SIGINT: 130,
+};
+/**
+ * 退出代码到描述的映射
+ */
+exports.ExitCodeDescription = {
+    [exports.ExitCode.SUCCESS]: '成功',
+    [exports.ExitCode.GENERAL_ERROR]: '通用错误',
+    [exports.ExitCode.INVALID_ARGUMENT]: '参数错误',
+    [exports.ExitCode.CONFIG_ERROR]: '配置错误',
+    [exports.ExitCode.PERMISSION_ERROR]: '权限不足',
+    [exports.ExitCode.SERVICE_ERROR]: '服务操作失败',
+    [exports.ExitCode.NETWORK_ERROR]: '网络错误',
+    [exports.ExitCode.FILE_ERROR]: '文件错误',
+    [exports.ExitCode.VALIDATION_ERROR]: '输入验证失败',
+    [exports.ExitCode.NOT_FOUND]: '资源未找到',
+    [exports.ExitCode.SIGINT]: '用户中断',
+};
+/**
+ * 根据错误类型获取退出代码
+ */
+function getExitCodeForError(error) {
+    const errorName = error.name.toLowerCase();
+    const errorMessage = error.message.toLowerCase();
+    // 根据错误名称或消息判断退出代码
+    if (errorName.includes('permission') || errorMessage.includes('eacces')) {
+        return exports.ExitCode.PERMISSION_ERROR;
+    }
+    if (errorName.includes('validation') || errorMessage.includes('invalid')) {
+        return exports.ExitCode.VALIDATION_ERROR;
+    }
+    if (errorName.includes('notfound') || errorMessage.includes('not found')) {
+        return exports.ExitCode.NOT_FOUND;
+    }
+    if (errorName.includes('config') || errorMessage.includes('config')) {
+        return exports.ExitCode.CONFIG_ERROR;
+    }
+    if (errorName.includes('service') || errorMessage.includes('systemctl')) {
+        return exports.ExitCode.SERVICE_ERROR;
+    }
+    if (errorName.includes('file') || errorMessage.includes('enoent')) {
+        return exports.ExitCode.FILE_ERROR;
+    }
+    if (errorName.includes('network') || errorMessage.includes('timeout')) {
+        return exports.ExitCode.NETWORK_ERROR;
+    }
+    return exports.ExitCode.GENERAL_ERROR;
+}
+/**
+ * 优雅退出（清理资源后退出）
+ */
+async function gracefulExit(code, cleanup) {
+    try {
+        if (cleanup) {
+            await cleanup();
+        }
+    }
+    catch (error) {
+        console.error('清理资源时出错:', error);
+    }
+    finally {
+        process.exit(code);
+    }
+}
+//# sourceMappingURL=exit-codes.js.map

package/dist/constants/exit-codes.js.map

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

package/dist/constants/paths.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 路径常量定义
+ * @module constants/paths
+ */
+/**
+ * 默认路径配置
+ */
+export declare const DEFAULT_PATHS: {
+    /** Xray 配置文件路径 */
+    readonly CONFIG_FILE: "/usr/local/etc/xray/config.json";
+    /** Xray 配置目录 */
+    readonly CONFIG_DIR: "/usr/local/etc/xray";
+    /** 配置备份目录 */
+    readonly BACKUP_DIR: "/var/backups/xray";
+    /** systemd 服务名称 */
+    readonly SERVICE_NAME: "xray";
+    /** systemd 服务文件路径 */
+    readonly SERVICE_FILE: "/etc/systemd/system/xray.service";
+    /** Xray 可执行文件路径 */
+    readonly XRAY_BINARY: "/usr/local/bin/xray";
+    /** 日志目录（如果使用文件日志） */
+    readonly LOG_DIR: "/var/log/xray";
+    /** 访问日志文件 */
+    readonly ACCESS_LOG: "/var/log/xray/access.log";
+    /** 错误日志文件 */
+    readonly ERROR_LOG: "/var/log/xray/error.log";
+    /** 临时文件目录 */
+    readonly TEMP_DIR: "/tmp/xray-manager";
+    /** 用户配置目录（~/.xray-manager） */
+    readonly USER_CONFIG_DIR: string;
+    /** 用户配置文件 */
+    readonly USER_CONFIG_FILE: string;
+};
+/**
+ * 路径验证规则
+ */
+export declare const PATH_VALIDATION: {
+    /** 配置文件必须以 .json 结尾 */
+    readonly CONFIG_FILE_EXTENSION: ".json";
+    /** 备份文件命名格式 */
+    readonly BACKUP_FILE_PATTERN: RegExp;
+    /** 最大路径长度 */
+    readonly MAX_PATH_LENGTH: 4096;
+};
+/**
+ * 备份文件名生成
+ */
+export declare function getBackupFileName(timestamp?: Date): string;
+/**
+ * 获取完整备份路径
+ */
+export declare function getBackupFilePath(timestamp?: Date): string;
+/**
+ * 检查路径是否为备份文件
+ */
+export declare function isBackupFile(filename: string): boolean;
+//# sourceMappingURL=paths.d.ts.map

package/dist/constants/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/constants/paths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB,kBAAkB;;IAGlB,gBAAgB;;IAGhB,aAAa;;IAGb,mBAAmB;;IAGnB,qBAAqB;;IAGrB,mBAAmB;;IAGnB,qBAAqB;;IAGrB,aAAa;;IAGb,aAAa;;IAGb,aAAa;;IAGb,8BAA8B;;IAG9B,aAAa;;CAEL,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe;IAC1B,uBAAuB;;IAGvB,eAAe;;IAGf,aAAa;;CAEL,CAAC;AAEX;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,GAAE,IAAiB,GAAG,MAAM,CAGtE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEtD"}

package/dist/constants/paths.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * 路径常量定义
+ * @module constants/paths
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PATH_VALIDATION = exports.DEFAULT_PATHS = void 0;
+exports.getBackupFileName = getBackupFileName;
+exports.getBackupFilePath = getBackupFilePath;
+exports.isBackupFile = isBackupFile;
+const os_1 = require("os");
+const path_1 = require("path");
+/**
+ * 默认路径配置
+ */
+exports.DEFAULT_PATHS = {
+    /** Xray 配置文件路径 */
+    CONFIG_FILE: '/usr/local/etc/xray/config.json',
+    /** Xray 配置目录 */
+    CONFIG_DIR: '/usr/local/etc/xray',
+    /** 配置备份目录 */
+    BACKUP_DIR: '/var/backups/xray',
+    /** systemd 服务名称 */
+    SERVICE_NAME: 'xray',
+    /** systemd 服务文件路径 */
+    SERVICE_FILE: '/etc/systemd/system/xray.service',
+    /** Xray 可执行文件路径 */
+    XRAY_BINARY: '/usr/local/bin/xray',
+    /** 日志目录（如果使用文件日志） */
+    LOG_DIR: '/var/log/xray',
+    /** 访问日志文件 */
+    ACCESS_LOG: '/var/log/xray/access.log',
+    /** 错误日志文件 */
+    ERROR_LOG: '/var/log/xray/error.log',
+    /** 临时文件目录 */
+    TEMP_DIR: '/tmp/xray-manager',
+    /** 用户配置目录（~/.xray-manager） */
+    USER_CONFIG_DIR: (0, path_1.join)((0, os_1.homedir)(), '.xray-manager'),
+    /** 用户配置文件 */
+    USER_CONFIG_FILE: (0, path_1.join)((0, os_1.homedir)(), '.xray-manager', 'config.json'),
+};
+/**
+ * 路径验证规则
+ */
+exports.PATH_VALIDATION = {
+    /** 配置文件必须以 .json 结尾 */
+    CONFIG_FILE_EXTENSION: '.json',
+    /** 备份文件命名格式 */
+    BACKUP_FILE_PATTERN: /^config\.\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}\.\d{3}Z\.json$/,
+    /** 最大路径长度 */
+    MAX_PATH_LENGTH: 4096,
+};
+/**
+ * 备份文件名生成
+ */
+function getBackupFileName(timestamp = new Date()) {
+    const isoString = timestamp.toISOString().replace(/:/g, '-');
+    return `config.${isoString}.json`;
+}
+/**
+ * 获取完整备份路径
+ */
+function getBackupFilePath(timestamp) {
+    return (0, path_1.join)(exports.DEFAULT_PATHS.BACKUP_DIR, getBackupFileName(timestamp));
+}
+/**
+ * 检查路径是否为备份文件
+ */
+function isBackupFile(filename) {
+    return exports.PATH_VALIDATION.BACKUP_FILE_PATTERN.test(filename);
+}
+//# sourceMappingURL=paths.js.map

package/dist/constants/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/constants/paths.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA+DH,8CAGC;AAKD,8CAEC;AAKD,oCAEC;AA9ED,2BAA6B;AAC7B,+BAA4B;AAE5B;;GAEG;AACU,QAAA,aAAa,GAAG;IAC3B,kBAAkB;IAClB,WAAW,EAAE,iCAAiC;IAE9C,gBAAgB;IAChB,UAAU,EAAE,qBAAqB;IAEjC,aAAa;IACb,UAAU,EAAE,mBAAmB;IAE/B,mBAAmB;IACnB,YAAY,EAAE,MAAM;IAEpB,qBAAqB;IACrB,YAAY,EAAE,kCAAkC;IAEhD,mBAAmB;IACnB,WAAW,EAAE,qBAAqB;IAElC,qBAAqB;IACrB,OAAO,EAAE,eAAe;IAExB,aAAa;IACb,UAAU,EAAE,0BAA0B;IAEtC,aAAa;IACb,SAAS,EAAE,yBAAyB;IAEpC,aAAa;IACb,QAAQ,EAAE,mBAAmB;IAE7B,8BAA8B;IAC9B,eAAe,EAAE,IAAA,WAAI,EAAC,IAAA,YAAO,GAAE,EAAE,eAAe,CAAC;IAEjD,aAAa;IACb,gBAAgB,EAAE,IAAA,WAAI,EAAC,IAAA,YAAO,GAAE,EAAE,eAAe,EAAE,aAAa,CAAC;CACzD,CAAC;AAEX;;GAEG;AACU,QAAA,eAAe,GAAG;IAC7B,uBAAuB;IACvB,qBAAqB,EAAE,OAAO;IAE9B,eAAe;IACf,mBAAmB,EAAE,6DAA6D;IAElF,aAAa;IACb,eAAe,EAAE,IAAI;CACb,CAAC;AAEX;;GAEG;AACH,SAAgB,iBAAiB,CAAC,YAAkB,IAAI,IAAI,EAAE;IAC5D,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC7D,OAAO,UAAU,SAAS,OAAO,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,SAAgB;IAChD,OAAO,IAAA,WAAI,EAAC,qBAAa,CAAC,UAAU,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC;AACtE,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,QAAgB;IAC3C,OAAO,uBAAe,CAAC,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC5D,CAAC"}

package/dist/constants/timeouts.d.ts

@@ -0,0 +1,84 @@
+/**
+ * 超时时间常量定义
+ * @module constants/timeouts
+ */
+/**
+ * 超时配置（单位：毫秒）
+ */
+export declare const TIMEOUTS: {
+    /** systemctl 命令默认超时 */
+    readonly SYSTEMCTL_DEFAULT: 30000;
+    /** 服务启动超时 */
+    readonly SERVICE_START: 15000;
+    /** 服务停止超时（优雅关闭） */
+    readonly SERVICE_STOP: 10000;
+    /** 服务重启超时 */
+    readonly SERVICE_RESTART: 25000;
+    /** 服务状态查询超时 */
+    readonly SERVICE_STATUS: 5000;
+    /** 配置文件读写超时 */
+    readonly CONFIG_IO: 5000;
+    /** 配置备份操作超时 */
+    readonly CONFIG_BACKUP: 10000;
+    /** 日志查询超时 */
+    readonly LOG_QUERY: 10000;
+    /** 网络操作超时（下载、检查更新） */
+    readonly NETWORK: 30000;
+    /** 用户输入超时（交互式菜单） */
+    readonly USER_INPUT: 60000;
+    /** 文件系统操作超时 */
+    readonly FILESYSTEM: 10000;
+    /** 优雅关闭等待时间 */
+    readonly GRACEFUL_SHUTDOWN: 10000;
+    /** 进程杀死前等待时间 */
+    readonly KILL_WAIT: 2000;
+    /** 菜单刷新间隔 */
+    readonly MENU_REFRESH: 1000;
+    /** 状态轮询间隔 */
+    readonly STATUS_POLL: 500;
+};
+/**
+ * 性能要求（用于监控和测试）
+ */
+export declare const PERFORMANCE_TARGETS: {
+    /** 菜单启动时间目标 */
+    readonly MENU_STARTUP: 500;
+    /** 菜单导航响应时间目标 */
+    readonly MENU_NAVIGATION: 100;
+    /** 按键响应时间目标 */
+    readonly KEY_RESPONSE: 50;
+    /** 服务重启中断时间目标 */
+    readonly SERVICE_DOWNTIME: 10000;
+};
+/**
+ * 重试配置
+ */
+export declare const RETRY_CONFIG: {
+    /** 默认重试次数 */
+    readonly DEFAULT_ATTEMPTS: 3;
+    /** 重试间隔（毫秒） */
+    readonly RETRY_DELAY: 1000;
+    /** 指数退避基数 */
+    readonly BACKOFF_MULTIPLIER: 2;
+    /** 最大重试间隔 */
+    readonly MAX_RETRY_DELAY: 10000;
+};
+/**
+ * 计算指数退避延迟
+ * @param attempt 当前尝试次数（从 0 开始）
+ * @returns 延迟时间（毫秒）
+ */
+export declare function getBackoffDelay(attempt: number): number;
+/**
+ * 睡眠函数（用于延迟）
+ * @param ms 毫秒数
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * 带超时的 Promise
+ * @param promise 原始 Promise
+ * @param timeoutMs 超时时间（毫秒）
+ * @param errorMessage 超时错误消息
+ */
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, errorMessage?: string): Promise<T>;
+//# sourceMappingURL=timeouts.d.ts.map

package/dist/constants/timeouts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeouts.d.ts","sourceRoot":"","sources":["../../src/constants/timeouts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,QAAQ;IACnB,uBAAuB;;IAGvB,aAAa;;IAGb,mBAAmB;;IAGnB,aAAa;;IAGb,eAAe;;IAGf,eAAe;;IAGf,eAAe;;IAGf,aAAa;;IAGb,sBAAsB;;IAGtB,oBAAoB;;IAGpB,eAAe;;IAGf,eAAe;;IAGf,gBAAgB;;IAGhB,aAAa;;IAGb,aAAa;;CAEL,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,mBAAmB;IAC9B,eAAe;;IAGf,iBAAiB;;IAGjB,eAAe;;IAGf,iBAAiB;;CAET,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB,aAAa;;IAGb,eAAe;;IAGf,aAAa;;IAGb,aAAa;;CAEL,CAAC;AAEX;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,SAAS,EAAE,MAAM,EACjB,YAAY,SAAS,GACpB,OAAO,CAAC,CAAC,CAAC,CAiBZ"}

package/dist/constants/timeouts.js

@@ -0,0 +1,111 @@
+"use strict";
+/**
+ * 超时时间常量定义
+ * @module constants/timeouts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RETRY_CONFIG = exports.PERFORMANCE_TARGETS = exports.TIMEOUTS = void 0;
+exports.getBackoffDelay = getBackoffDelay;
+exports.sleep = sleep;
+exports.withTimeout = withTimeout;
+/**
+ * 超时配置（单位：毫秒）
+ */
+exports.TIMEOUTS = {
+    /** systemctl 命令默认超时 */
+    SYSTEMCTL_DEFAULT: 30000, // 30 秒
+    /** 服务启动超时 */
+    SERVICE_START: 15000, // 15 秒
+    /** 服务停止超时（优雅关闭） */
+    SERVICE_STOP: 10000, // 10 秒
+    /** 服务重启超时 */
+    SERVICE_RESTART: 25000, // 25 秒
+    /** 服务状态查询超时 */
+    SERVICE_STATUS: 5000, // 5 秒
+    /** 配置文件读写超时 */
+    CONFIG_IO: 5000, // 5 秒
+    /** 配置备份操作超时 */
+    CONFIG_BACKUP: 10000, // 10 秒
+    /** 日志查询超时 */
+    LOG_QUERY: 10000, // 10 秒
+    /** 网络操作超时（下载、检查更新） */
+    NETWORK: 30000, // 30 秒
+    /** 用户输入超时（交互式菜单） */
+    USER_INPUT: 60000, // 60 秒
+    /** 文件系统操作超时 */
+    FILESYSTEM: 10000, // 10 秒
+    /** 优雅关闭等待时间 */
+    GRACEFUL_SHUTDOWN: 10000, // 10 秒
+    /** 进程杀死前等待时间 */
+    KILL_WAIT: 2000, // 2 秒
+    /** 菜单刷新间隔 */
+    MENU_REFRESH: 1000, // 1 秒
+    /** 状态轮询间隔 */
+    STATUS_POLL: 500, // 500 毫秒
+};
+/**
+ * 性能要求（用于监控和测试）
+ */
+exports.PERFORMANCE_TARGETS = {
+    /** 菜单启动时间目标 */
+    MENU_STARTUP: 500, // 500ms (SC-003)
+    /** 菜单导航响应时间目标 */
+    MENU_NAVIGATION: 100, // 100ms (SC-002)
+    /** 按键响应时间目标 */
+    KEY_RESPONSE: 50, // 50ms (SC-002)
+    /** 服务重启中断时间目标 */
+    SERVICE_DOWNTIME: 10000, // 10s (FR-016)
+};
+/**
+ * 重试配置
+ */
+exports.RETRY_CONFIG = {
+    /** 默认重试次数 */
+    DEFAULT_ATTEMPTS: 3,
+    /** 重试间隔（毫秒） */
+    RETRY_DELAY: 1000, // 1 秒
+    /** 指数退避基数 */
+    BACKOFF_MULTIPLIER: 2,
+    /** 最大重试间隔 */
+    MAX_RETRY_DELAY: 10000, // 10 秒
+};
+/**
+ * 计算指数退避延迟
+ * @param attempt 当前尝试次数（从 0 开始）
+ * @returns 延迟时间（毫秒）
+ */
+function getBackoffDelay(attempt) {
+    const delay = exports.RETRY_CONFIG.RETRY_DELAY * Math.pow(exports.RETRY_CONFIG.BACKOFF_MULTIPLIER, attempt);
+    return Math.min(delay, exports.RETRY_CONFIG.MAX_RETRY_DELAY);
+}
+/**
+ * 睡眠函数（用于延迟）
+ * @param ms 毫秒数
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * 带超时的 Promise
+ * @param promise 原始 Promise
+ * @param timeoutMs 超时时间（毫秒）
+ * @param errorMessage 超时错误消息
+ */
+async function withTimeout(promise, timeoutMs, errorMessage = '操作超时') {
+    let timeoutId;
+    const timeoutPromise = new Promise((_, reject) => {
+        timeoutId = setTimeout(() => {
+            reject(new Error(`${errorMessage} (${timeoutMs}ms)`));
+        }, timeoutMs);
+    });
+    try {
+        const result = await Promise.race([promise, timeoutPromise]);
+        clearTimeout(timeoutId);
+        return result;
+    }
+    catch (error) {
+        clearTimeout(timeoutId);
+        throw error;
+    }
+}
+//# sourceMappingURL=timeouts.js.map

package/dist/constants/timeouts.js.map

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

package/dist/services/config-manager.d.ts

@@ -0,0 +1,66 @@
+/**
+ * ConfigManager - Xray Configuration File Management
+ *
+ * Provides safe interface to read, write, validate, and backup Xray config
+ *
+ * @module services/config-manager
+ */
+import type { XrayConfig } from '../types/config';
+/**
+ * ConfigManager - Safe configuration file operations
+ */
+export declare class ConfigManager {
+    private configPath;
+    private backupDir;
+    /**
+     * Create a new ConfigManager
+     *
+     * @param configPath - Path to config file (default: /usr/local/etc/xray/config.json)
+     */
+    constructor(configPath?: string);
+    /**
+     * Read and parse config file
+     *
+     * @returns Parsed configuration object
+     */
+    readConfig(): Promise<XrayConfig>;
+    /**
+     * Write config to file with secure permissions
+     *
+     * @param config - Configuration object to write
+     */
+    writeConfig(config: XrayConfig): Promise<void>;
+    /**
+     * Validate configuration structure
+     *
+     * @param config - Configuration to validate
+     * @throws Error if validation fails
+     */
+    validateConfig(config: XrayConfig): void;
+    /**
+     * Backup configuration file
+     *
+     * @returns Path to backup file
+     */
+    backupConfig(): Promise<string>;
+    /**
+     * List available backups
+     *
+     * @returns Array of backup file paths
+     */
+    listBackups(): Promise<string[]>;
+    /**
+     * Restore configuration from backup
+     *
+     * @param backupPath - Path to backup file
+     */
+    restoreConfig(backupPath: string): Promise<void>;
+    /**
+     * Modify a configuration item
+     *
+     * @param path - Dot-separated path to config item (e.g., "log.loglevel")
+     * @param value - New value
+     */
+    modifyConfigItem(path: string, value: any): Promise<void>;
+}
+//# sourceMappingURL=config-manager.d.ts.map

package/dist/services/config-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.d.ts","sourceRoot":"","sources":["../../src/services/config-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;IAE1B;;;;OAIG;gBACS,UAAU,CAAC,EAAE,MAAM;IAK/B;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;IAiBvC;;;;OAIG;IACG,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBpD;;;;;OAKG;IACH,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAgCxC;;;;OAIG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAyBrC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAmBtC;;;;OAIG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBtD;;;;;OAKG;IACG,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;CAqBhE"}