@feng3d/ctc 0.0.6

package/dist/handlers/unified-handler.js

@@ -0,0 +1,373 @@
+/**
+ * @module handlers/unified-handler
+ *
+ * 统一代理连接处理器模块。
+ *
+ * 负责处理通过穿透隧道传输的 HTTP 和 WebSocket 连接。
+ * 同时支持 HTTP 请求转发和 WebSocket 连接桥接，无需区分协议类型。
+ */
+import { EventEmitter } from 'events';
+import { WebSocket } from 'ws';
+import { request as httpRequest } from 'http';
+import { request as httpsRequest } from 'https';
+import { URL } from 'url';
+import { logger } from '@feng3d/chuantou-shared';
+import { MessageType, createMessage, } from '@feng3d/chuantou-shared';
+/**
+ * 统一代理连接处理器类。
+ *
+ * 继承自 {@link EventEmitter}，负责在远程客户端和本地服务之间建立双向数据转发通道。
+ * 同时支持 HTTP 请求转发和 WebSocket 连接桥接。
+ *
+ * 工作流程：
+ * 1. 监听控制器的 `newConnection` 事件，接收新的连接请求
+ * 2. 根据协议类型（http/websocket）建立相应的本地连接
+ * 3. 将本地服务发送的数据转发给服务器
+ * 4. 将服务器转发的远程客户端数据转发到本地服务
+ * 5. 处理连接关闭和错误情况
+ *
+ * 触发的事件：
+ * - `error` - 处理连接时发生错误
+ */
+export class UnifiedHandler extends EventEmitter {
+    /**
+     * 创建统一处理器实例。
+     *
+     * 自动监听控制器的 `newConnection` 和 `connectionClose` 事件，
+     * 并设置数据转发监听器。
+     *
+     * @param controller - 控制器实例，用于与服务器通信
+     * @param config - 代理配置对象，包含本地服务地址和端口
+     */
+    constructor(controller, config) {
+        super();
+        /** 正在处理的 HTTP 连接映射表 */
+        this.pendingConnections = new Map();
+        /** 本地 WebSocket 连接映射表 */
+        this.localWsConnections = new Map();
+        /** 流式 HTTP 响应映射表（如 SSE） */
+        this.streamingResponses = new Map();
+        this.controller = controller;
+        this.config = config;
+        // 监听新连接事件
+        this.controller.on('newConnection', (msg) => {
+            if (msg.payload.protocol === 'http') {
+                this.handleHttpConnection(msg);
+            }
+            else if (msg.payload.protocol === 'websocket') {
+                this.handleWebSocketConnection(msg);
+            }
+        });
+        // 监听来自服务器的数据消息
+        this.setupDataListener();
+        // 监听连接关闭事件
+        this.controller.on('connectionClose', (msg) => {
+            this.handleConnectionClose(msg);
+        });
+    }
+    /**
+     * 设置从服务器接收数据的监听器。
+     */
+    setupDataListener() {
+        const controller = this.controller;
+        if (controller.ws) {
+            controller.ws.on('message', (data) => {
+                try {
+                    const msg = JSON.parse(data.toString());
+                    if (msg.type === 'connection_data') {
+                        this.handleClientData(msg.connectionId, msg.data);
+                    }
+                }
+                catch {
+                    // 忽略解析错误
+                }
+            });
+        }
+    }
+    /**
+     * 处理来自服务器的新 HTTP 连接请求。
+     */
+    async handleHttpConnection(msg) {
+        const { connectionId, method, url, headers, body } = msg.payload;
+        logger.log(`HTTP 请求: ${method} ${url} (${connectionId})`);
+        // 构建本地 URL
+        const localUrl = `http://${this.config.localHost || 'localhost'}:${this.config.localPort}${url}`;
+        const parsedUrl = new URL(localUrl);
+        // 准备请求选项
+        const options = {
+            method,
+            hostname: parsedUrl.hostname,
+            port: parsedUrl.port || this.config.localPort,
+            path: parsedUrl.pathname + parsedUrl.search,
+            headers: this.filterHeaders(headers),
+            rejectUnauthorized: false,
+        };
+        // 创建请求
+        const requestFn = parsedUrl.protocol === 'https:' ? httpsRequest : httpRequest;
+        try {
+            const req = requestFn(options, (res) => {
+                const contentType = (res.headers['content-type'] || '').toLowerCase();
+                const isSSE = contentType.includes('text/event-stream');
+                if (isSSE) {
+                    // SSE 流式转发 - 先发送响应头
+                    logger.log(`SSE 流: ${url} (${connectionId})`);
+                    this.sendResponseHeaders(connectionId, {
+                        statusCode: res.statusCode || 200,
+                        headers: res.headers,
+                    });
+                    this.streamingResponses.set(connectionId, res);
+                    res.on('data', (chunk) => {
+                        this.forwardStreamData(connectionId, chunk);
+                    });
+                    res.on('end', () => {
+                        logger.log(`SSE 结束: ${connectionId}`);
+                        this.notifyStreamEnd(connectionId);
+                        this.streamingResponses.delete(connectionId);
+                    });
+                    res.on('error', (error) => {
+                        logger.error(`SSE 错误 ${connectionId}:`, error.message);
+                        this.notifyStreamEnd(connectionId);
+                        this.streamingResponses.delete(connectionId);
+                    });
+                }
+                else {
+                    // 普通 HTTP 请求，收集完整响应体后一次性发送
+                    const chunks = [];
+                    res.on('data', (chunk) => {
+                        chunks.push(chunk);
+                    });
+                    res.on('end', () => {
+                        const body = Buffer.concat(chunks);
+                        this.sendResponse(connectionId, {
+                            statusCode: res.statusCode || 200,
+                            headers: res.headers,
+                            body: body.toString('base64'),
+                        });
+                    });
+                    res.on('error', (error) => {
+                        this.sendError(connectionId, error.message);
+                    });
+                }
+            });
+            req.on('error', (error) => {
+                this.sendError(connectionId, error.message);
+            });
+            // 发送请求体
+            if (body) {
+                req.write(Buffer.from(body, 'base64'));
+            }
+            req.end();
+            // 存储请求引用，用于取消
+            this.pendingConnections.set(connectionId, { req });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.sendError(connectionId, errorMessage);
+        }
+    }
+    /**
+     * 处理来自服务器的新 WebSocket 连接请求。
+     */
+    handleWebSocketConnection(msg) {
+        const { connectionId, url, wsHeaders } = msg.payload;
+        logger.log(`WebSocket 连接: ${url} (${connectionId})`);
+        // 构建本地 WebSocket URL
+        const localUrl = `ws://${this.config.localHost || 'localhost'}:${this.config.localPort}${url}`;
+        // 连接到本地 WebSocket 服务
+        const localWs = new WebSocket(localUrl, {
+            headers: this.filterHeaders(wsHeaders),
+        });
+        localWs.on('open', () => {
+            logger.log(`本地 WebSocket 已连接: ${connectionId}`);
+        });
+        localWs.on('message', (data) => {
+            this.forwardToServer(connectionId, data);
+        });
+        localWs.on('close', (code, reason) => {
+            logger.log(`本地 WebSocket 已关闭: ${connectionId} (${code})`);
+            this.notifyServerClose(connectionId, code);
+            this.cleanupWsConnection(connectionId);
+        });
+        localWs.on('error', (error) => {
+            logger.error(`本地 WebSocket 错误 ${connectionId}:`, error.message);
+            this.notifyServerClose(connectionId, 1011);
+            this.cleanupWsConnection(connectionId);
+        });
+        this.localWsConnections.set(connectionId, localWs);
+    }
+    /**
+     * 将本地数据转发到服务器。
+     */
+    forwardToServer(connectionId, data) {
+        const controller = this.controller;
+        if (controller.ws && controller.ws.readyState === WebSocket.OPEN) {
+            controller.ws.send(JSON.stringify({
+                type: 'connection_data',
+                connectionId,
+                data: data.toString('base64'),
+            }));
+        }
+    }
+    /**
+     * 处理从服务器接收到的远程客户端数据。
+     */
+    handleClientData(connectionId, data) {
+        const localWs = this.localWsConnections.get(connectionId);
+        if (localWs && localWs.readyState === WebSocket.OPEN) {
+            localWs.send(Buffer.from(data, 'base64'));
+        }
+    }
+    /**
+     * 将 HTTP 响应数据发送回服务器。
+     */
+    sendResponse(connectionId, response) {
+        const controller = this.controller;
+        if (controller.ws && controller.ws.readyState === WebSocket.OPEN) {
+            controller.ws.send(JSON.stringify({
+                type: 'http_response',
+                connectionId,
+                ...response,
+            }));
+        }
+        this.pendingConnections.delete(connectionId);
+    }
+    /**
+     * 发送流式响应头（用于 SSE）。
+     */
+    sendResponseHeaders(connectionId, headers) {
+        const controller = this.controller;
+        if (controller.ws && controller.ws.readyState === WebSocket.OPEN) {
+            controller.ws.send(JSON.stringify({
+                type: 'http_response_headers',
+                connectionId,
+                ...headers,
+            }));
+        }
+    }
+    /**
+     * 发送流式响应数据块（用于 SSE）。
+     */
+    forwardStreamData(connectionId, data) {
+        const controller = this.controller;
+        if (controller.ws && controller.ws.readyState === WebSocket.OPEN) {
+            controller.ws.send(JSON.stringify({
+                type: 'http_response_data',
+                connectionId,
+                data: data.toString('base64'),
+            }));
+        }
+    }
+    /**
+     * 通知服务器流式响应结束（用于 SSE）。
+     */
+    notifyStreamEnd(connectionId) {
+        const controller = this.controller;
+        if (controller.ws && controller.ws.readyState === WebSocket.OPEN) {
+            controller.ws.send(JSON.stringify({
+                type: 'http_response_end',
+                connectionId,
+            }));
+        }
+    }
+    /**
+     * 向服务器发送错误响应。
+     */
+    sendError(connectionId, error) {
+        this.sendResponse(connectionId, {
+            statusCode: 500,
+            headers: {},
+            body: error,
+        });
+        this.emit('error', new Error(`连接 ${connectionId} 错误: ${error}`));
+    }
+    /**
+     * 通知服务器某个 WebSocket 连接已关闭。
+     */
+    notifyServerClose(connectionId, code) {
+        const closeMsg = createMessage(MessageType.CONNECTION_CLOSE, {
+            connectionId,
+        });
+        this.controller.sendMessage(closeMsg);
+    }
+    /**
+     * 处理来自服务器的连接关闭通知。
+     */
+    handleConnectionClose(msg) {
+        const { connectionId } = msg.payload;
+        // 关闭 HTTP 连接
+        const pending = this.pendingConnections.get(connectionId);
+        if (pending) {
+            pending.req.destroy();
+            this.pendingConnections.delete(connectionId);
+        }
+        // 关闭流式响应（如 SSE）
+        const streaming = this.streamingResponses.get(connectionId);
+        if (streaming) {
+            streaming.destroy();
+            this.streamingResponses.delete(connectionId);
+        }
+        // 关闭 WebSocket 连接
+        const localWs = this.localWsConnections.get(connectionId);
+        if (localWs) {
+            localWs.close(1000, '服务器已关闭连接');
+        }
+        this.cleanupWsConnection(connectionId);
+    }
+    /**
+     * 清理 WebSocket 连接资源。
+     */
+    cleanupWsConnection(connectionId) {
+        const localWs = this.localWsConnections.get(connectionId);
+        if (localWs) {
+            localWs.removeAllListeners();
+        }
+        this.localWsConnections.delete(connectionId);
+    }
+    /**
+     * 过滤请求头，移除逐跳头部字段。
+     */
+    filterHeaders(headers) {
+        if (!headers) {
+            return {};
+        }
+        const filtered = {};
+        const hopByHopHeaders = [
+            'connection',
+            'keep-alive',
+            'proxy-authenticate',
+            'proxy-authorization',
+            'te',
+            'trailers',
+            'transfer-encoding',
+            'upgrade',
+        ];
+        for (const [key, value] of Object.entries(headers)) {
+            if (!hopByHopHeaders.includes(key.toLowerCase()) && value !== undefined) {
+                filtered[key] = Array.isArray(value) ? value.join(', ') : value;
+            }
+        }
+        return filtered;
+    }
+    /**
+     * 销毁处理器，释放所有资源。
+     */
+    destroy() {
+        // 销毁 HTTP 连接
+        for (const { req } of this.pendingConnections.values()) {
+            req.destroy();
+        }
+        this.pendingConnections.clear();
+        // 销毁流式响应
+        for (const res of this.streamingResponses.values()) {
+            res.destroy();
+        }
+        this.streamingResponses.clear();
+        // 销毁 WebSocket 连接
+        for (const ws of this.localWsConnections.values()) {
+            ws.close(1000, '处理器已销毁');
+        }
+        this.localWsConnections.clear();
+        this.removeAllListeners();
+    }
+}
+//# sourceMappingURL=unified-handler.js.map

package/dist/handlers/unified-handler.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @module @feng3d/ctc
+ *
+ * 穿透（Chuantou）内网穿透客户端主入口模块。
+ *
+ * 该模块提供了客户端的核心功能导出和独立运行入口。
+ * 作为库使用时，可以导入 {@link Config}、{@link Controller}、{@link ProxyManager} 等核心类；
+ * 作为独立程序运行时，会自动加载配置、连接服务器并注册代理隧道。
+ */
+/**
+ * 导出核心类和类型，供作为库使用时引用。
+ */
+export { Config } from './config.js';
+export { Controller } from './controller.js';
+export { ProxyManager } from './proxy-manager.js';
+export { AdminServer } from './admin-server.js';
+export { UnifiedHandler } from './handlers/unified-handler.js';
+export type { ClientConfig, ProxyConfig } from '@feng3d/chuantou-shared';
+/**
+ * 导出运行函数供 CLI 使用。
+ *
+ * 该函数是 {@link main} 的公开包装，用于被 CLI 模块调用以启动客户端。
+ *
+ * @returns 无返回值的 Promise
+ */
+export declare function run(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AA8IzE;;;;;;GAMG;AACH,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAEzC"}

package/dist/index.js

@@ -0,0 +1,154 @@
+/**
+ * @module @feng3d/ctc
+ *
+ * 穿透（Chuantou）内网穿透客户端主入口模块。
+ *
+ * 该模块提供了客户端的核心功能导出和独立运行入口。
+ * 作为库使用时，可以导入 {@link Config}、{@link Controller}、{@link ProxyManager} 等核心类；
+ * 作为独立程序运行时，会自动加载配置、连接服务器并注册代理隧道。
+ */
+import { Config } from './config.js';
+import { Controller } from './controller.js';
+import { ProxyManager } from './proxy-manager.js';
+import { AdminServer } from './admin-server.js';
+import { logger } from '@feng3d/chuantou-shared';
+/**
+ * 导出核心类和类型，供作为库使用时引用。
+ */
+export { Config } from './config.js';
+export { Controller } from './controller.js';
+export { ProxyManager } from './proxy-manager.js';
+export { AdminServer } from './admin-server.js';
+export { UnifiedHandler } from './handlers/unified-handler.js';
+/**
+ * 客户端主入口函数（独立运行模式）。
+ *
+ * 执行以下步骤：
+ * 1. 从配置文件或命令行参数加载配置
+ * 2. 验证配置合法性
+ * 3. 创建控制器并连接服务器
+ * 4. 认证成功后注册所有代理隧道
+ * 5. 启动本地 HTTP 管理页面服务器
+ * 6. 监听进程信号实现优雅关闭
+ *
+ * @returns 无返回值的 Promise
+ */
+async function main() {
+    logger.log('正在启动穿透客户端...');
+    // 加载配置（从用户目录 .chuantou/client.json 或命令行参数）
+    const config = await Config.load();
+    // 验证配置
+    config.validate();
+    logger.log('配置已加载:');
+    logger.log(`  服务器地址: ${config.serverUrl}`);
+    logger.log(`  代理数量: 已配置 ${config.proxies.length} 个`);
+    for (const proxy of config.proxies) {
+        logger.log(`    - :${proxy.remotePort} -> ${proxy.localHost || 'localhost'}:${proxy.localPort}`);
+    }
+    // 记录启动时间
+    const startTime = Date.now();
+    // 创建控制器
+    const controller = new Controller(config);
+    // 创建代理管理器
+    const proxyManager = new ProxyManager(controller);
+    // 已注册的代理配置列表（用于管理页面）
+    const registeredProxies = [];
+    for (const p of config.proxies) {
+        registeredProxies.push({ ...p });
+    }
+    // 创建管理页面服务器
+    const adminServer = new AdminServer({ port: 9001, host: '127.0.0.1' }, 
+    // 获取状态回调
+    () => ({
+        running: true,
+        serverUrl: config.serverUrl,
+        connected: controller.isConnected(),
+        authenticated: controller.isAuthenticated(),
+        uptime: Date.now() - startTime,
+        proxies: registeredProxies.map(p => ({ ...p })),
+        reconnectAttempts: controller.getReconnectAttempts(),
+    }), 
+    // 添加代理回调
+    async (proxy) => {
+        await proxyManager.registerProxy(proxy);
+        registeredProxies.push({ ...proxy });
+    }, 
+    // 删除代理回调
+    async (remotePort) => {
+        await proxyManager.unregisterProxy(remotePort);
+        const index = registeredProxies.findIndex(p => p.remotePort === remotePort);
+        if (index !== -1) {
+            registeredProxies.splice(index, 1);
+        }
+    });
+    // 监听控制器事件
+    controller.on('connected', () => {
+        logger.log('已连接到服务器');
+    });
+    controller.on('disconnected', () => {
+        logger.log('已断开与服务器的连接');
+    });
+    controller.on('authenticated', async () => {
+        logger.log('已认证，正在注册代理...');
+        // 注册所有代理
+        for (const proxyConfig of config.proxies) {
+            try {
+                await proxyManager.registerProxy(proxyConfig);
+                // 代理配置已在初始化时添加到 registeredProxies
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                logger.error(`注册代理失败: ${errorMessage}`);
+            }
+        }
+        // 启动管理页面服务器
+        try {
+            await adminServer.start();
+        }
+        catch (error) {
+            logger.error('管理页面启动失败:', error);
+        }
+    });
+    controller.on('maxReconnectAttemptsReached', () => {
+        logger.error('已达到最大重连次数，正在退出...');
+        process.exit(1);
+    });
+    // 优雅关闭
+    const shutdown = async () => {
+        logger.log('\n正在关闭...');
+        await adminServer.stop();
+        await proxyManager.destroy();
+        controller.disconnect();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+    // 连接到服务器
+    try {
+        await controller.connect();
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger.error('连接服务器失败:', errorMessage);
+        process.exit(1);
+    }
+}
+// 检查是否作为主模块运行
+const isMainModule = import.meta.url === `file://${process.argv[1].replace(/\\/g, '/')}`;
+if (isMainModule) {
+    main().catch((error) => {
+        logger.error('启动客户端失败:', error);
+        process.exit(1);
+    });
+}
+/**
+ * 导出运行函数供 CLI 使用。
+ *
+ * 该函数是 {@link main} 的公开包装，用于被 CLI 模块调用以启动客户端。
+ *
+ * @returns 无返回值的 Promise
+ */
+export async function run() {
+    return main();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/proxy-manager.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @module proxy-manager
+ *
+ * 代理管理器模块。
+ *
+ * 负责管理所有代理隧道的生命周期，包括向服务器注册/注销代理、
+ * 创建统一的处理器（同时支持 HTTP 和 WebSocket）、
+ * 以及在连接断开时清理所有处理器。
+ */
+import { Controller } from './controller.js';
+import { ProxyConfig } from '@feng3d/chuantou-shared';
+/**
+ * 代理管理器类，负责管理所有代理隧道的注册、注销和生命周期。
+ *
+ * 创建统一的处理器实例，每个端口同时支持 HTTP 和 WebSocket 协议。
+ * 当控制器连接断开时，自动清理所有处理器。
+ *
+ * @example
+ * ```typescript
+ * const proxyManager = new ProxyManager(controller);
+ * await proxyManager.registerProxy({ remotePort: 8080, localPort: 3000 });
+ * ```
+ */
+export declare class ProxyManager {
+    /** 控制器实例，用于与服务器通信 */
+    private controller;
+    /** 代理处理器映射表，键为远程端口号，值为对应的处理器实例 */
+    private handlers;
+    /**
+     * 创建代理管理器实例。
+     *
+     * @param controller - 控制器实例，用于与服务器进行通信
+     */
+    constructor(controller: Controller);
+    /**
+     * 向服务器注册一个代理隧道。
+     *
+     * 发送注册消息到服务器，注册成功后创建统一的处理器
+     * （{@link UnifiedHandler}）并存储到处理器映射表中。
+     * 每个端口同时支持 HTTP 和 WebSocket 协议。
+     *
+     * @param config - 代理配置对象，包含远程端口、本地端口等信息
+     * @throws {Error} 注册失败时抛出错误，包含服务器返回的错误信息
+     */
+    registerProxy(config: ProxyConfig): Promise<void>;
+    /**
+     * 注销指定远程端口的代理隧道。
+     *
+     * 销毁对应的处理器，并向服务器发送注销请求。
+     *
+     * @param remotePort - 要注销的代理对应的远程端口号
+     */
+    unregisterProxy(remotePort: number): Promise<void>;
+    /**
+     * 注销所有已注册的代理隧道。
+     *
+     * 并行注销所有代理，等待全部注销完成后返回。
+     *
+     * @returns 所有代理注销完成后解析的 Promise
+     */
+    unregisterAll(): Promise<void>;
+    /**
+     * 处理控制器连接断开事件。
+     *
+     * 销毁所有处理器并清空处理器映射表。
+     */
+    private onDisconnected;
+    /**
+     * 销毁代理管理器，注销所有代理并释放资源。
+     *
+     * @returns 销毁完成后解析的 Promise
+     */
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=proxy-manager.d.ts.map

package/dist/proxy-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-manager.d.ts","sourceRoot":"","sources":["../src/proxy-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAU,MAAM,yBAAyB,CAAC;AAI9D;;;;;;;;;;;GAWG;AACH,qBAAa,YAAY;IACvB,qBAAqB;IACrB,OAAO,CAAC,UAAU,CAAa;IAE/B,kCAAkC;IAClC,OAAO,CAAC,QAAQ,CAA8B;IAE9C;;;;OAIG;gBACS,UAAU,EAAE,UAAU;IAUlC;;;;;;;;;OASG;IACG,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BvD;;;;;;OAMG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAexD;;;;;;OAMG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAQpC;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAQtB;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}