xray-manager 1.0.0

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

@@ -0,0 +1,63 @@
+/**
+ * UserManager - User Management with Auto UUID Generation
+ *
+ * Provides safe user management with automatic service restart
+ *
+ * @module services/user-manager
+ */
+import type { User, CreateUserParams, UserShareInfo } from '../types/user';
+/**
+ * UserManager - Manage Xray users
+ */
+export declare class UserManager {
+    private configManager;
+    private systemdManager;
+    private serviceName;
+    /**
+     * Create a new UserManager
+     *
+     * @param configPath - Optional config file path
+     * @param serviceName - Service name (default: xray)
+     */
+    constructor(configPath?: string, serviceName?: string);
+    /**
+     * Generate a new UUID v4 using crypto.randomUUID()
+     *
+     * @returns UUID string
+     */
+    generateUuid(): string;
+    /**
+     * Validate email address
+     *
+     * @param email - Email to validate
+     * @throws Error if email is invalid
+     */
+    validateEmail(email: string): void;
+    /**
+     * List all users from config
+     *
+     * @returns Array of users
+     */
+    listUsers(): Promise<User[]>;
+    /**
+     * Add a new user with auto-generated UUID
+     *
+     * @param params - User creation parameters
+     * @returns Created user
+     */
+    addUser(params: CreateUserParams): Promise<User>;
+    /**
+     * Delete user by ID
+     *
+     * @param userId - User ID (UUID) to delete
+     */
+    deleteUser(userId: string): Promise<void>;
+    /**
+     * Get share information for a user
+     *
+     * @param userId - User ID (UUID)
+     * @returns Share information including VLESS link
+     */
+    getShareInfo(userId: string): Promise<UserShareInfo>;
+}
+//# sourceMappingURL=user-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"user-manager.d.ts","sourceRoot":"","sources":["../../src/services/user-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG3E;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;;OAKG;gBACS,UAAU,CAAC,EAAE,MAAM,EAAE,WAAW,GAAE,MAAe;IAM7D;;;;OAIG;IACH,YAAY,IAAI,MAAM;IAItB;;;;;OAKG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMlC;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAuBlC;;;;;OAKG;IACG,OAAO,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmEtD;;;;OAIG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+B/C;;;;;OAKG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAqD3D"}

package/dist/services/user-manager.js

@@ -0,0 +1,219 @@
+"use strict";
+/**
+ * UserManager - User Management with Auto UUID Generation
+ *
+ * Provides safe user management with automatic service restart
+ *
+ * @module services/user-manager
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserManager = void 0;
+const crypto_1 = require("crypto");
+const config_manager_1 = require("./config-manager");
+const systemd_manager_1 = require("./systemd-manager");
+const validator_1 = require("../utils/validator");
+/**
+ * UserManager - Manage Xray users
+ */
+class UserManager {
+    /**
+     * Create a new UserManager
+     *
+     * @param configPath - Optional config file path
+     * @param serviceName - Service name (default: xray)
+     */
+    constructor(configPath, serviceName = 'xray') {
+        this.configManager = new config_manager_1.ConfigManager(configPath);
+        this.systemdManager = new systemd_manager_1.SystemdManager(serviceName);
+        this.serviceName = serviceName;
+    }
+    /**
+     * Generate a new UUID v4 using crypto.randomUUID()
+     *
+     * @returns UUID string
+     */
+    generateUuid() {
+        return (0, crypto_1.randomUUID)();
+    }
+    /**
+     * Validate email address
+     *
+     * @param email - Email to validate
+     * @throws Error if email is invalid
+     */
+    validateEmail(email) {
+        if (!(0, validator_1.isValidEmail)(email)) {
+            throw new Error(`无效的邮箱地址: ${email}`);
+        }
+    }
+    /**
+     * List all users from config
+     *
+     * @returns Array of users
+     */
+    async listUsers() {
+        const config = await this.configManager.readConfig();
+        const users = [];
+        // Extract users from all inbounds
+        for (const inbound of config.inbounds || []) {
+            if (inbound.settings?.clients) {
+                for (const client of inbound.settings.clients) {
+                    users.push({
+                        id: client.id,
+                        email: client.email || '',
+                        level: client.level || 0,
+                        flow: client.flow,
+                        createdAt: new Date().toISOString(), // TODO: Get from metadata
+                        status: 'active', // TODO: Get from config
+                    });
+                }
+            }
+        }
+        return users;
+    }
+    /**
+     * Add a new user with auto-generated UUID
+     *
+     * @param params - User creation parameters
+     * @returns Created user
+     */
+    async addUser(params) {
+        // Validate email
+        this.validateEmail(params.email);
+        // Check for duplicate email
+        const existingUsers = await this.listUsers();
+        const duplicate = existingUsers.find((u) => u.email === params.email);
+        if (duplicate) {
+            throw new Error(`邮箱地址已存在: ${params.email}`);
+        }
+        // Backup config before modification
+        await this.configManager.backupConfig();
+        // Generate UUID
+        const id = this.generateUuid();
+        const now = new Date().toISOString();
+        // Create user object
+        const newUser = {
+            id,
+            email: params.email,
+            level: params.level ?? 0,
+            flow: params.flow,
+            createdAt: now,
+            status: 'active',
+        };
+        // Read config
+        const config = await this.configManager.readConfig();
+        // Find first VLESS or VMess inbound and add user
+        let added = false;
+        for (const inbound of config.inbounds || []) {
+            if (inbound.protocol === 'vless' || inbound.protocol === 'vmess') {
+                if (!inbound.settings) {
+                    inbound.settings = { clients: [] };
+                }
+                if (!inbound.settings.clients) {
+                    inbound.settings.clients = [];
+                }
+                inbound.settings.clients.push({
+                    id,
+                    email: params.email,
+                    level: params.level,
+                    flow: params.flow,
+                });
+                added = true;
+                break;
+            }
+        }
+        if (!added) {
+            throw new Error('配置文件中未找到 VLESS 或 VMess inbound');
+        }
+        // Write config
+        await this.configManager.writeConfig(config);
+        // Restart service
+        await this.systemdManager.restart();
+        return newUser;
+    }
+    /**
+     * Delete user by ID
+     *
+     * @param userId - User ID (UUID) to delete
+     */
+    async deleteUser(userId) {
+        // Backup config before modification
+        await this.configManager.backupConfig();
+        // Read config
+        const config = await this.configManager.readConfig();
+        // Find and remove user
+        let found = false;
+        for (const inbound of config.inbounds || []) {
+            if (inbound.settings?.clients) {
+                const index = inbound.settings.clients.findIndex((c) => c.id === userId);
+                if (index !== -1) {
+                    inbound.settings.clients.splice(index, 1);
+                    found = true;
+                    break;
+                }
+            }
+        }
+        if (!found) {
+            throw new Error(`用户不存在: ${userId}`);
+        }
+        // Write config
+        await this.configManager.writeConfig(config);
+        // Restart service
+        await this.systemdManager.restart();
+    }
+    /**
+     * Get share information for a user
+     *
+     * @param userId - User ID (UUID)
+     * @returns Share information including VLESS link
+     */
+    async getShareInfo(userId) {
+        const config = await this.configManager.readConfig();
+        // Find user
+        let user;
+        let inboundPort;
+        let inboundProtocol;
+        for (const inbound of config.inbounds || []) {
+            if (inbound.settings?.clients) {
+                const client = inbound.settings.clients.find((c) => c.id === userId);
+                if (client) {
+                    user = {
+                        id: client.id,
+                        email: client.email || '',
+                        level: client.level || 0,
+                        flow: client.flow,
+                        createdAt: new Date().toISOString(),
+                        status: 'active',
+                    };
+                    inboundPort = inbound.port;
+                    inboundProtocol = inbound.protocol;
+                    break;
+                }
+            }
+        }
+        if (!user) {
+            throw new Error(`用户不存在: ${userId}`);
+        }
+        // Generate VLESS link
+        // Format: vless://UUID@server:port?encryption=none&security=tls&type=tcp&flow=xtls-rprx-vision#email
+        const serverAddress = 'your-server-ip'; // TODO: Get from config or system
+        const port = inboundPort || 443;
+        const encryption = 'none';
+        const security = 'tls';
+        const type = 'tcp';
+        const flow = user.flow || 'xtls-rprx-vision';
+        const name = encodeURIComponent(user.email);
+        const vlessLink = `vless://${user.id}@${serverAddress}:${port}?encryption=${encryption}&security=${security}&type=${type}&flow=${flow}#${name}`;
+        return {
+            user,
+            shareLink: vlessLink,
+            serverAddress,
+            serverPort: port,
+            protocol: inboundProtocol || 'vless',
+            security,
+            qrCode: vlessLink, // QR code would be generated from this
+        };
+    }
+}
+exports.UserManager = UserManager;
+//# sourceMappingURL=user-manager.js.map

package/dist/services/user-manager.js.map

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

package/dist/types/config.d.ts

@@ -0,0 +1,256 @@
+/**
+ * Xray 配置文件类型定义
+ * @module types/config
+ */
+/**
+ * Xray 配置文件顶层结构
+ * 对应文件: /usr/local/etc/xray/config.json
+ */
+export interface XrayConfig {
+    /** 日志配置 */
+    log: LogConfig;
+    /** 入站连接配置 */
+    inbounds: Inbound[];
+    /** 出站连接配置 */
+    outbounds: Outbound[];
+    /** 路由规则 */
+    routing?: RoutingConfig;
+    /** DNS 配置 */
+    dns?: DnsConfig;
+}
+/**
+ * 日志配置
+ */
+export interface LogConfig {
+    /** 日志级别: debug, info, warning, error, none */
+    loglevel: 'debug' | 'info' | 'warning' | 'error' | 'none';
+    /** 访问日志路径（空字符串表示不记录） */
+    access: string;
+    /** 错误日志路径（空字符串表示不记录） */
+    error: string;
+}
+/**
+ * 入站连接配置（服务端监听）
+ */
+export interface Inbound {
+    /** 监听端口 */
+    port: number;
+    /** 监听地址（默认 0.0.0.0） */
+    listen?: string;
+    /** 协议类型: vless, vmess, trojan, shadowsocks 等 */
+    protocol: 'vless' | 'vmess' | 'trojan' | 'shadowsocks';
+    /** 协议特定配置 */
+    settings: InboundSettings;
+    /** 流传输配置（TLS, TCP, WebSocket 等） */
+    streamSettings?: StreamSettings;
+    /** 嗅探配置 */
+    sniffing?: SniffingConfig;
+    /** 标签（用于路由引用） */
+    tag?: string;
+}
+/**
+ * 出站连接配置（客户端连接外部）
+ */
+export interface Outbound {
+    /** 协议类型 */
+    protocol: 'freedom' | 'blackhole' | 'socks' | 'http' | 'shadowsocks' | 'vmess' | 'vless';
+    /** 协议特定配置 */
+    settings?: OutboundSettings;
+    /** 流传输配置 */
+    streamSettings?: StreamSettings;
+    /** 标签（用于路由引用） */
+    tag: string;
+}
+/**
+ * 入站协议配置（VLESS 为例）
+ */
+export interface InboundSettings {
+    /** 客户端列表 */
+    clients: XrayClient[];
+    /** 解密方式（VLESS 必须为 "none"） */
+    decryption?: string;
+    /** 回落配置（用于伪装） */
+    fallbacks?: Fallback[];
+}
+/**
+ * 出站协议配置
+ */
+export interface OutboundSettings {
+    /** 域名解析策略 */
+    domainStrategy?: 'AsIs' | 'UseIP' | 'UseIPv4' | 'UseIPv6';
+    /** 其他配置 */
+    [key: string]: unknown;
+}
+/**
+ * Xray 客户端（用户）
+ */
+export interface XrayClient {
+    /** 用户唯一标识（UUID v4 格式） */
+    id: string;
+    /** 用户邮箱或标识符（用于管理） */
+    email?: string;
+    /** 协议级别（0 表示默认） */
+    level?: number;
+    /** 流控模式（xtls-rprx-vision 等） */
+    flow?: string;
+}
+/**
+ * 流传输配置
+ */
+export interface StreamSettings {
+    /** 传输层协议: tcp, ws, http, grpc 等 */
+    network: 'tcp' | 'ws' | 'http' | 'grpc';
+    /** TLS/Reality 安全配置 */
+    security: 'none' | 'tls' | 'reality';
+    /** TLS 配置 */
+    tlsSettings?: TlsSettings;
+    /** Reality 配置 */
+    realitySettings?: RealitySettings;
+    /** TCP 配置 */
+    tcpSettings?: TcpSettings;
+    /** WebSocket 配置 */
+    wsSettings?: WsSettings;
+}
+/**
+ * TLS 配置
+ */
+export interface TlsSettings {
+    /** 服务器名称指示（SNI） */
+    serverName?: string;
+    /** 证书配置 */
+    certificates: Certificate[];
+    /** ALPN 协议列表 */
+    alpn?: string[];
+}
+/**
+ * Reality 协议配置（新型伪装协议）
+ */
+export interface RealitySettings {
+    /** 目标网站地址（用于伪装） */
+    dest: string;
+    /** 服务器名称列表 */
+    serverNames: string[];
+    /** 私钥 */
+    privateKey: string;
+    /** 短 ID 列表 */
+    shortIds: string[];
+    /** 最小客户端版本 */
+    minClientVer?: string;
+    /** 最大客户端版本 */
+    maxClientVer?: string;
+    /** 最大时间差（秒） */
+    maxTimeDiff?: number;
+}
+/**
+ * 证书配置
+ */
+export interface Certificate {
+    /** 证书用途: sign, verify, issue */
+    usage: 'sign' | 'verify' | 'issue';
+    /** 证书文件路径 */
+    certificateFile?: string;
+    /** 私钥文件路径 */
+    keyFile?: string;
+    /** 证书内容（Base64 编码） */
+    certificate?: string[];
+    /** 私钥内容（Base64 编码） */
+    key?: string[];
+}
+/**
+ * TCP 配置
+ */
+export interface TcpSettings {
+    /** HTTP 头部伪装 */
+    header?: {
+        type: 'none' | 'http';
+        request?: HttpRequest;
+        response?: HttpResponse;
+    };
+}
+/**
+ * HTTP 请求配置（用于伪装）
+ */
+export interface HttpRequest {
+    version?: string;
+    method?: string;
+    path?: string[];
+    headers?: Record<string, string[]>;
+}
+/**
+ * HTTP 响应配置（用于伪装）
+ */
+export interface HttpResponse {
+    version?: string;
+    status?: string;
+    reason?: string;
+    headers?: Record<string, string[]>;
+}
+/**
+ * WebSocket 配置
+ */
+export interface WsSettings {
+    /** WebSocket 路径 */
+    path: string;
+    /** HTTP 头部 */
+    headers?: Record<string, string>;
+}
+/**
+ * 嗅探配置（流量识别）
+ */
+export interface SniffingConfig {
+    /** 是否启用嗅探 */
+    enabled: boolean;
+    /** 嗅探目标: http, tls, quic */
+    destOverride: ('http' | 'tls' | 'quic')[];
+}
+/**
+ * 回落配置（用于伪装和负载均衡）
+ */
+export interface Fallback {
+    /** ALPN 协议 */
+    alpn?: string;
+    /** 路径匹配 */
+    path?: string;
+    /** 目标地址 */
+    dest: string | number;
+    /** 目标 xver（PROXY protocol） */
+    xver?: number;
+}
+/**
+ * 路由配置
+ */
+export interface RoutingConfig {
+    /** 域名解析策略 */
+    domainStrategy?: 'AsIs' | 'IPIfNonMatch' | 'IPOnDemand';
+    /** 路由规则列表 */
+    rules?: RoutingRule[];
+}
+/**
+ * 路由规则
+ */
+export interface RoutingRule {
+    /** 规则类型 */
+    type?: 'field';
+    /** 域名匹配 */
+    domain?: string[];
+    /** IP 匹配 */
+    ip?: string[];
+    /** 端口匹配 */
+    port?: string;
+    /** 出站标签 */
+    outboundTag: string;
+    /** 入站标签 */
+    inboundTag?: string[];
+}
+/**
+ * DNS 配置
+ */
+export interface DnsConfig {
+    /** DNS 服务器列表 */
+    servers?: string[];
+    /** 静态主机映射 */
+    hosts?: Record<string, string | string[]>;
+    /** 域名匹配 */
+    tag?: string;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

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

package/dist/types/config.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Xray 配置文件类型定义
+ * @module types/config
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/types/service.d.ts

@@ -0,0 +1,96 @@
+/**
+ * 服务管理相关类型定义
+ * @module types/service
+ */
+/**
+ * 服务状态信息
+ */
+export interface ServiceStatus {
+    /** 服务名称 */
+    serviceName: string;
+    /** 是否活跃 */
+    active: boolean;
+    /** 活跃状态: active, inactive, activating, deactivating, failed */
+    activeState: 'active' | 'inactive' | 'activating' | 'deactivating' | 'failed';
+    /** 子状态: running, exited, dead, failed, etc. */
+    subState: string;
+    /** 是否已加载 */
+    loaded: boolean;
+    /** 主进程 PID */
+    pid: number | null;
+    /** 运行时长（格式化字符串，如 "2天 3小时 15分钟"） */
+    uptime: string;
+    /** 内存占用（格式化字符串，如 "45.2 MB"） */
+    memory: string;
+    /** 重启次数 */
+    restarts: number;
+    /** 服务是否健康（综合判断） */
+    healthy: boolean;
+    /** 最后日志行（可选） */
+    lastLog?: string;
+}
+/**
+ * 服务操作结果
+ */
+export interface ServiceOperationResult {
+    /** 操作是否成功 */
+    success: boolean;
+    /** 操作类型 */
+    operation: 'start' | 'stop' | 'restart' | 'enable' | 'disable' | 'status';
+    /** 服务名称 */
+    serviceName: string;
+    /** 标准输出 */
+    stdout?: string;
+    /** 错误输出 */
+    stderr?: string;
+    /** 退出代码 */
+    exitCode: number;
+    /** 执行时长（毫秒） */
+    duration?: number;
+    /** 中断时间（毫秒，仅 restart） */
+    downtime?: number;
+    /** 错误消息（如果失败） */
+    error?: string;
+}
+/**
+ * systemd 服务操作类型
+ */
+export type ServiceOperation = 'start' | 'stop' | 'restart' | 'enable' | 'disable' | 'status' | 'is-active' | 'is-enabled' | 'show';
+/**
+ * systemd show 命令输出的属性映射
+ */
+export interface SystemdShowOutput {
+    ActiveState?: string;
+    SubState?: string;
+    LoadState?: string;
+    MainPID?: string;
+    ExecMainStartTimestamp?: string;
+    MemoryCurrent?: string;
+    NRestarts?: string;
+    [key: string]: string | undefined;
+}
+/**
+ * 服务管理选项
+ */
+export interface ServiceManagerOptions {
+    /** systemctl 命令路径 */
+    systemctlPath?: string;
+    /** 是否使用 sudo */
+    useSudo?: boolean;
+    /** 超时时间（毫秒） */
+    timeout?: number;
+    /** 是否启用详细日志 */
+    verbose?: boolean;
+}
+/**
+ * 优雅关闭选项
+ */
+export interface GracefulShutdownOptions {
+    /** 优雅关闭超时（毫秒） */
+    timeout: number;
+    /** 是否等待连接完成 */
+    waitForConnections?: boolean;
+    /** 是否显示进度 */
+    showProgress?: boolean;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/types/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/types/service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IAEpB,WAAW;IACX,MAAM,EAAE,OAAO,CAAC;IAEhB,+DAA+D;IAC/D,WAAW,EAAE,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,cAAc,GAAG,QAAQ,CAAC;IAE9E,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IAEjB,YAAY;IACZ,MAAM,EAAE,OAAO,CAAC;IAEhB,cAAc;IACd,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IAEf,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IAEf,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IAEjB,mBAAmB;IACnB,OAAO,EAAE,OAAO,CAAC;IAEjB,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,aAAa;IACb,OAAO,EAAE,OAAO,CAAC;IAEjB,WAAW;IACX,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IAE1E,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IAEpB,WAAW;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,WAAW;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IAEjB,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,OAAO,GACP,MAAM,GACN,SAAS,GACT,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,qBAAqB;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,gBAAgB;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,eAAe;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC;IAEhB,eAAe;IACf,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B,aAAa;IACb,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB"}

package/dist/types/service.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * 服务管理相关类型定义
+ * @module types/service
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=service.js.map

package/dist/types/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/types/service.ts"],"names":[],"mappings":";AAAA;;;GAGG"}