proxy-api-mcp 1.0.0

package/api-tools.json.example

@@ -0,0 +1,226 @@
+{
+  "version": "1.0",
+  "globals": {
+    "timeout": "${API_TIMEOUT:30000}",
+    "headers": {
+      "User-Agent": "${USER_AGENT:DefinesysMCP/1.0}"
+    }
+  },
+  "tools": [
+    {
+      "name": "get_user_by_id",
+      "title": "Get User By ID",
+      "description": "Retrieve user information by user ID from JSONPlaceholder API",
+      "method": "GET",
+      "baseUrl": "${JSONPLACEHOLDER_BASE_URL:https://jsonplaceholder.typicode.com}",
+      "path": "/users/{userId}",
+      "parameters": [
+        {
+          "name": "userId",
+          "in": "path",
+          "description": "The ID of the user to retrieve",
+          "required": true,
+          "type": "integer"
+        }
+      ],
+      "responseTransform": {
+        "dataPath": "",
+        "fieldMapping": {
+          "id": "id",
+          "userName": "username",
+          "userEmail": "email",
+          "userPhone": "phone"
+        }
+      },
+      "enabled": true
+    },
+    {
+      "name": "list_posts",
+      "title": "List Posts",
+      "description": "Get a list of posts, optionally filtered by user ID",
+      "method": "GET",
+      "baseUrl": "${JSONPLACEHOLDER_BASE_URL:https://jsonplaceholder.typicode.com}",
+      "path": "/posts",
+      "parameters": [
+        {
+          "name": "userId",
+          "in": "query",
+          "description": "Filter posts by user ID",
+          "required": false,
+          "type": "integer"
+        },
+        {
+          "name": "_limit",
+          "in": "query",
+          "description": "Limit the number of results",
+          "required": false,
+          "type": "integer",
+          "default": 10
+        }
+      ],
+      "enabled": true
+    },
+    {
+      "name": "create_post",
+      "title": "Create Post",
+      "description": "Create a new post",
+      "method": "POST",
+      "baseUrl": "${JSONPLACEHOLDER_BASE_URL:https://jsonplaceholder.typicode.com}",
+      "path": "/posts",
+      "requestBody": {
+        "description": "Post data to create",
+        "required": true,
+        "contentType": "application/json",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "title": {
+              "type": "string",
+              "description": "Post title"
+            },
+            "body": {
+              "type": "string",
+              "description": "Post content"
+            },
+            "userId": {
+              "type": "integer",
+              "description": "User ID of the post author"
+            }
+          },
+          "required": ["title", "body", "userId"]
+        }
+      },
+      "enabled": true
+    },
+    {
+      "name": "update_post",
+      "title": "Update Post",
+      "description": "Update an existing post",
+      "method": "PUT",
+      "baseUrl": "${JSONPLACEHOLDER_BASE_URL:https://jsonplaceholder.typicode.com}",
+      "path": "/posts/{postId}",
+      "parameters": [
+        {
+          "name": "postId",
+          "in": "path",
+          "description": "The ID of the post to update",
+          "required": true,
+          "type": "integer"
+        }
+      ],
+      "requestBody": {
+        "description": "Updated post data",
+        "required": true,
+        "contentType": "application/json",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "title": {
+              "type": "string",
+              "description": "Updated post title"
+            },
+            "body": {
+              "type": "string",
+              "description": "Updated post content"
+            },
+            "userId": {
+              "type": "integer",
+              "description": "User ID of the post author"
+            }
+          },
+          "required": ["title", "body", "userId"]
+        }
+      },
+      "enabled": true
+    },
+    {
+      "name": "delete_post",
+      "title": "Delete Post",
+      "description": "Delete a post by ID",
+      "method": "DELETE",
+      "baseUrl": "${JSONPLACEHOLDER_BASE_URL:https://jsonplaceholder.typicode.com}",
+      "path": "/posts/{postId}",
+      "parameters": [
+        {
+          "name": "postId",
+          "in": "path",
+          "description": "The ID of the post to delete",
+          "required": true,
+          "type": "integer"
+        }
+      ],
+      "enabled": true
+    },
+    {
+      "name": "search_github_repos",
+      "title": "Search GitHub Repositories",
+      "description": "Search for GitHub repositories by keyword",
+      "method": "GET",
+      "baseUrl": "https://api.github.com",
+      "path": "/search/repositories",
+      "headers": {
+        "Authorization": "Bearer ${GITHUB_TOKEN:}",
+        "Accept": "application/vnd.github.v3+json"
+      },
+      "parameters": [
+        {
+          "name": "q",
+          "in": "query",
+          "description": "Search keyword",
+          "required": true,
+          "type": "string"
+        },
+        {
+          "name": "sort",
+          "in": "query",
+          "description": "Sort field",
+          "required": false,
+          "type": "string",
+          "enum": ["stars", "forks", "updated"],
+          "default": "stars"
+        },
+        {
+          "name": "order",
+          "in": "query",
+          "description": "Sort order",
+          "required": false,
+          "type": "string",
+          "enum": ["asc", "desc"],
+          "default": "desc"
+        },
+        {
+          "name": "per_page",
+          "in": "query",
+          "description": "Results per page",
+          "required": false,
+          "type": "integer",
+          "default": 10
+        }
+      ],
+      "responseTransform": {
+        "dataPath": "items"
+      },
+      "enabled": true
+    },
+    {
+      "name": "api_with_preprocessor_example",
+      "title": "API with Preprocessor Example",
+      "description": "Demonstrates using a preprocessor to add timestamp and custom headers to requests",
+      "method": "GET",
+      "baseUrl": "${JSONPLACEHOLDER_BASE_URL:https://jsonplaceholder.typicode.com}",
+      "path": "/posts",
+      "preprocessor": "add_timestamp",
+      "parameters": [
+        {
+          "name": "_limit",
+          "in": "query",
+          "description": "Limit the number of results",
+          "required": false,
+          "type": "integer",
+          "default": 5
+        }
+      ],
+      "enabled": false
+    }
+  ]
+}

package/dist/examples/env-in-json-usage.d.ts

@@ -0,0 +1,43 @@
+/**
+ * API 配置中环境变量使用示例
+ *
+ * 本示例演示如何在 api-tools.json 配置文件中使用环境变量
+ */
+/**
+ * 示例 1: 基本的环境变量替换
+ */
+declare function example1BasicReplacement(): void;
+/**
+ * 示例 2: 使用默认值
+ */
+declare function example2WithDefaults(): void;
+/**
+ * 示例 3: 验证环境变量
+ */
+declare function example3Validation(): void;
+/**
+ * 示例 4: 提取环境变量名称
+ */
+declare function example4ExtractVariables(): void;
+/**
+ * 示例 5: 检查是否包含占位符
+ */
+declare function example5HasPlaceholder(): void;
+/**
+ * 示例 6: 从配置文件加载 API 工具
+ */
+declare function example6LoadApiTools(): Promise<void>;
+/**
+ * 示例 7: 多环境配置
+ */
+declare function example7MultiEnvironment(): void;
+/**
+ * 示例 8: 错误处理
+ */
+declare function example8ErrorHandling(): void;
+/**
+ * 示例 9: 复杂对象替换
+ */
+declare function example9ComplexObject(): void;
+export { example1BasicReplacement, example2WithDefaults, example3Validation, example4ExtractVariables, example5HasPlaceholder, example6LoadApiTools, example7MultiEnvironment, example8ErrorHandling, example9ComplexObject, };
+//# sourceMappingURL=env-in-json-usage.d.ts.map

package/dist/examples/env-in-json-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-in-json-usage.d.ts","sourceRoot":"","sources":["../../examples/env-in-json-usage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH;;GAEG;AACH,iBAAS,wBAAwB,SAoBhC;AAED;;GAEG;AACH,iBAAS,oBAAoB,SAoB5B;AAED;;GAEG;AACH,iBAAS,kBAAkB,SAqB1B;AAED;;GAEG;AACH,iBAAS,wBAAwB,SAehC;AAED;;GAEG;AACH,iBAAS,sBAAsB,SAa9B;AAED;;GAEG;AACH,iBAAe,oBAAoB,kBAqBlC;AAED;;GAEG;AACH,iBAAS,wBAAwB,SAiChC;AAED;;GAEG;AACH,iBAAS,qBAAqB,SAoB7B;AAED;;GAEG;AACH,iBAAS,qBAAqB,SAsC7B;AAoCD,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,EACrB,qBAAqB,GACtB,CAAC"}

package/dist/examples/env-in-json-usage.js

@@ -0,0 +1,242 @@
+/**
+ * API 配置中环境变量使用示例
+ *
+ * 本示例演示如何在 api-tools.json 配置文件中使用环境变量
+ */
+import { ApiToolLoader } from '../src/tools/api/loader.js';
+import { replaceEnvVariables, validateEnvVariables, extractEnvVariables, hasEnvPlaceholder, } from '../src/utils/env-replacer.js';
+/**
+ * 示例 1: 基本的环境变量替换
+ */
+function example1BasicReplacement() {
+    console.log('\n=== 示例 1: 基本的环境变量替换 ===\n');
+    const config = {
+        baseUrl: '${API_BASE_URL}',
+        timeout: '${API_TIMEOUT}',
+        headers: {
+            Authorization: 'Bearer ${API_TOKEN}',
+        },
+    };
+    console.log('原始配置:', JSON.stringify(config, null, 2));
+    // 设置环境变量(实际使用时应在 .env 文件中设置)
+    process.env.API_BASE_URL = 'https://api.example.com';
+    process.env.API_TIMEOUT = '30000';
+    process.env.API_TOKEN = 'demo_token_123';
+    const result = replaceEnvVariables(config);
+    console.log('\n替换后的配置:', JSON.stringify(result, null, 2));
+}
+/**
+ * 示例 2: 使用默认值
+ */
+function example2WithDefaults() {
+    console.log('\n=== 示例 2: 使用默认值 ===\n');
+    const config = {
+        baseUrl: '${API_BASE_URL:https://api.example.com}',
+        timeout: '${API_TIMEOUT:30000}',
+        headers: {
+            'User-Agent': '${USER_AGENT:DefinesysMCP/1.0}',
+        },
+    };
+    console.log('原始配置:', JSON.stringify(config, null, 2));
+    // 清除可能存在的环境变量
+    delete process.env.API_BASE_URL;
+    delete process.env.API_TIMEOUT;
+    delete process.env.USER_AGENT;
+    const result = replaceEnvVariables(config);
+    console.log('\n替换后的配置(使用默认值):', JSON.stringify(result, null, 2));
+}
+/**
+ * 示例 3: 验证环境变量
+ */
+function example3Validation() {
+    console.log('\n=== 示例 3: 验证环境变量 ===\n');
+    const config = {
+        baseUrl: '${API_BASE_URL}',
+        token: '${API_TOKEN}',
+        optionalValue: '${OPTIONAL_VALUE:default}',
+    };
+    console.log('配置:', JSON.stringify(config, null, 2));
+    // 设置部分环境变量
+    process.env.API_BASE_URL = 'https://api.example.com';
+    delete process.env.API_TOKEN; // API_TOKEN 未设置
+    const validation = validateEnvVariables(config);
+    console.log('\n验证结果:', validation);
+    if (!validation.valid) {
+        console.log('缺失的环境变量:', validation.missing.join(', '));
+    }
+}
+/**
+ * 示例 4: 提取环境变量名称
+ */
+function example4ExtractVariables() {
+    console.log('\n=== 示例 4: 提取环境变量名称 ===\n');
+    const str1 = '${API_BASE_URL}/api/${API_VERSION}/users';
+    const str2 = 'Bearer ${API_TOKEN}';
+    const str3 = '${TIMEOUT:30000}';
+    console.log(`字符串: "${str1}"`);
+    console.log('包含环境变量:', extractEnvVariables(str1));
+    console.log(`\n字符串: "${str2}"`);
+    console.log('包含环境变量:', extractEnvVariables(str2));
+    console.log(`\n字符串: "${str3}"`);
+    console.log('包含环境变量:', extractEnvVariables(str3));
+}
+/**
+ * 示例 5: 检查是否包含占位符
+ */
+function example5HasPlaceholder() {
+    console.log('\n=== 示例 5: 检查是否包含占位符 ===\n');
+    const strings = [
+        'https://api.example.com',
+        '${API_BASE_URL}',
+        'Bearer ${TOKEN}',
+        '${API_URL:https://api.example.com}',
+    ];
+    strings.forEach(str => {
+        console.log(`"${str}" 包含占位符: ${hasEnvPlaceholder(str)}`);
+    });
+}
+/**
+ * 示例 6: 从配置文件加载 API 工具
+ */
+async function example6LoadApiTools() {
+    console.log('\n=== 示例 6: 从配置文件加载 API 工具 ===\n');
+    // 设置必需的环境变量
+    process.env.JSONPLACEHOLDER_BASE_URL = 'https://jsonplaceholder.typicode.com';
+    process.env.API_TIMEOUT = '30000';
+    process.env.USER_AGENT = 'DefinesysMCP/1.0';
+    try {
+        const configPath = './api-tools.json';
+        console.log(`从 ${configPath} 加载 API 工具配置...`);
+        const tools = await ApiToolLoader.loadFromFile(configPath);
+        console.log(`\n成功加载 ${tools.length} 个 API 工具:`);
+        tools.forEach((tool, index) => {
+            console.log(`  ${index + 1}. ${tool.name} - ${tool.description}`);
+        });
+    }
+    catch (error) {
+        console.error('加载失败:', error instanceof Error ? error.message : error);
+    }
+}
+/**
+ * 示例 7: 多环境配置
+ */
+function example7MultiEnvironment() {
+    console.log('\n=== 示例 7: 多环境配置 ===\n');
+    const config = {
+        version: '1.0',
+        globals: {
+            baseUrl: '${API_BASE_URL}',
+            timeout: '${API_TIMEOUT:30000}',
+            headers: {
+                Authorization: 'Bearer ${API_TOKEN}',
+            },
+        },
+    };
+    console.log('配置模板:', JSON.stringify(config, null, 2));
+    // 开发环境
+    console.log('\n--- 开发环境 ---');
+    process.env.API_BASE_URL = 'https://dev-api.example.com';
+    process.env.API_TOKEN = 'dev_token_123';
+    delete process.env.API_TIMEOUT;
+    const devConfig = replaceEnvVariables({ ...config });
+    console.log('开发环境配置:', JSON.stringify(devConfig, null, 2));
+    // 生产环境
+    console.log('\n--- 生产环境 ---');
+    process.env.API_BASE_URL = 'https://api.example.com';
+    process.env.API_TOKEN = 'prod_token_xyz';
+    process.env.API_TIMEOUT = '15000';
+    const prodConfig = replaceEnvVariables({ ...config });
+    console.log('生产环境配置:', JSON.stringify(prodConfig, null, 2));
+}
+/**
+ * 示例 8: 错误处理
+ */
+function example8ErrorHandling() {
+    console.log('\n=== 示例 8: 错误处理 ===\n');
+    const config = {
+        baseUrl: '${REQUIRED_API_URL}',
+        token: '${REQUIRED_TOKEN}',
+    };
+    console.log('配置:', JSON.stringify(config, null, 2));
+    // 清除环境变量,模拟缺失情况
+    delete process.env.REQUIRED_API_URL;
+    delete process.env.REQUIRED_TOKEN;
+    try {
+        replaceEnvVariables(config);
+    }
+    catch (error) {
+        console.log('\n捕获到错误:', error instanceof Error ? error.message : error);
+        console.log('错误类型:', error?.constructor.name);
+    }
+}
+/**
+ * 示例 9: 复杂对象替换
+ */
+function example9ComplexObject() {
+    console.log('\n=== 示例 9: 复杂对象替换 ===\n');
+    const config = {
+        version: '1.0',
+        globals: {
+            baseUrl: '${API_BASE_URL:https://api.example.com}',
+            timeout: '${API_TIMEOUT:30000}',
+        },
+        tools: [
+            {
+                name: 'get_user',
+                baseUrl: '${USER_SERVICE_URL}',
+                path: '/users/{id}',
+                headers: {
+                    Authorization: 'Bearer ${API_TOKEN}',
+                    'X-API-Key': '${API_KEY:default_key}',
+                },
+            },
+            {
+                name: 'get_posts',
+                baseUrl: '${POST_SERVICE_URL:https://posts.example.com}',
+                path: '/posts',
+            },
+        ],
+    };
+    console.log('原始配置:', JSON.stringify(config, null, 2));
+    // 设置环境变量
+    process.env.API_BASE_URL = 'https://api.example.com';
+    process.env.USER_SERVICE_URL = 'https://users.example.com';
+    process.env.API_TOKEN = 'secret_token';
+    delete process.env.API_KEY;
+    delete process.env.POST_SERVICE_URL;
+    const result = replaceEnvVariables(config);
+    console.log('\n替换后的配置:', JSON.stringify(result, null, 2));
+}
+/**
+ * 主函数 - 运行所有示例
+ */
+async function main() {
+    console.log('='.repeat(70));
+    console.log('API 配置中环境变量使用示例');
+    console.log('='.repeat(70));
+    try {
+        // 运行所有示例
+        example1BasicReplacement();
+        example2WithDefaults();
+        example3Validation();
+        example4ExtractVariables();
+        example5HasPlaceholder();
+        await example6LoadApiTools();
+        example7MultiEnvironment();
+        example8ErrorHandling();
+        example9ComplexObject();
+        console.log(`\n${'='.repeat(70)}`);
+        console.log('所有示例执行完成!');
+        console.log('='.repeat(70));
+    }
+    catch (error) {
+        console.error('\n执行示例时出错:', error);
+        process.exit(1);
+    }
+}
+// 运行示例
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main().catch(console.error);
+}
+export { example1BasicReplacement, example2WithDefaults, example3Validation, example4ExtractVariables, example5HasPlaceholder, example6LoadApiTools, example7MultiEnvironment, example8ErrorHandling, example9ComplexObject, };
+//# sourceMappingURL=env-in-json-usage.js.map

package/dist/examples/env-in-json-usage.js.map

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

package/dist/examples/env-usage.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 环境变量使用示例
+ *
+ * 本文件展示如何在项目中使用环境变量管理类
+ */
+export {};
+//# sourceMappingURL=env-usage.d.ts.map

package/dist/examples/env-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-usage.d.ts","sourceRoot":"","sources":["../../examples/env-usage.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/examples/env-usage.js

@@ -0,0 +1,108 @@
+/**
+ * 环境变量使用示例
+ *
+ * 本文件展示如何在项目中使用环境变量管理类
+ */
+import { env } from '../src/config/env.js';
+// ===== 示例 1: 获取单个环境变量 =====
+function example1() {
+    console.log('\n===== 示例 1: 获取单个环境变量 =====');
+    const port = env.get('MCP_PORT');
+    console.log(`服务器端口: ${port}`);
+    const transport = env.get('MCP_TRANSPORT');
+    console.log(`传输模式: ${transport}`);
+    const logLevel = env.get('MCP_LOG_LEVEL');
+    console.log(`日志级别: ${logLevel}`);
+}
+// ===== 示例 2: 获取所有环境变量 =====
+function example2() {
+    console.log('\n===== 示例 2: 获取所有环境变量 =====');
+    const allEnv = env.getAll();
+    console.log('所有环境变量:', allEnv);
+}
+// ===== 示例 3: 检查环境变量是否存在 =====
+function example3() {
+    console.log('\n===== 示例 3: 检查环境变量是否存在 =====');
+    if (env.has('MCP_PORT')) {
+        console.log('✓ MCP_PORT 已配置');
+    }
+    if (env.has('MCP_API_TOOLS_CONFIG')) {
+        console.log('✓ MCP_API_TOOLS_CONFIG 已配置');
+    }
+}
+// ===== 示例 4: 验证环境变量 =====
+function example4() {
+    console.log('\n===== 示例 4: 验证环境变量 =====');
+    try {
+        env.validate();
+        console.log('✓ 所有环境变量验证通过');
+    }
+    catch (error) {
+        console.error('✗ 环境变量验证失败:', error);
+    }
+}
+// ===== 示例 5: 判断运行环境 =====
+function example5() {
+    console.log('\n===== 示例 5: 判断运行环境 =====');
+    if (env.isProduction()) {
+        console.log('当前环境: Production');
+    }
+    else if (env.isDevelopment()) {
+        console.log('当前环境: Development');
+    }
+    else if (env.isTest()) {
+        console.log('当前环境: Test');
+    }
+}
+// ===== 示例 6: 在配置中使用环境变量 =====
+function example6() {
+    console.log('\n===== 示例 6: 在配置中使用环境变量 =====');
+    const serverConfig = {
+        name: 'proxy-api-mcp',
+        version: '1.0.0',
+        transport: env.get('MCP_TRANSPORT'),
+        port: env.get('MCP_PORT'),
+        sessionTimeout: env.get('MCP_SESSION_TIMEOUT'),
+        logLevel: env.get('MCP_LOG_LEVEL'),
+    };
+    console.log('服务器配置:', serverConfig);
+}
+// ===== 示例 7: 条件逻辑 =====
+function example7() {
+    console.log('\n===== 示例 7: 条件逻辑 =====');
+    const port = env.get('MCP_PORT');
+    if (port < 1024) {
+        console.log('警告: 使用特权端口,可能需要管理员权限');
+    }
+    else {
+        console.log('使用非特权端口:', port);
+    }
+    const timeout = env.get('MCP_SESSION_TIMEOUT');
+    const minutes = timeout / 1000 / 60;
+    console.log(`会话超时时间: ${minutes} 分钟`);
+}
+// ===== 示例 8: 打印环境变量配置 =====
+function example8() {
+    console.log('\n===== 示例 8: 打印环境变量配置 =====');
+    env.print();
+}
+// 运行所有示例
+async function runAllExamples() {
+    console.log('========================================');
+    console.log('环境变量使用示例');
+    console.log('========================================');
+    example1();
+    example2();
+    example3();
+    example4();
+    example5();
+    example6();
+    example7();
+    example8();
+    console.log('\n========================================');
+    console.log('所有示例执行完成');
+    console.log('========================================\n');
+}
+// 执行示例
+runAllExamples().catch(console.error);
+//# sourceMappingURL=env-usage.js.map

package/dist/examples/env-usage.js.map

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

package/dist/examples/preprocessor-usage.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 预处理器完整使用示例
+ * 演示如何在实际项目中使用预处理器功能
+ */
+import { type RequestPreprocessor } from '../src/tools/api/index.js';
+export declare function setupPreprocessors(): void;
+export declare function exampleUsage(): void;
+/**
+ * 根据配置动态创建预处理器
+ */
+export declare function createDynamicPreprocessor(name: string, config: Record<string, unknown>): RequestPreprocessor;
+export declare function setupDynamicPreprocessor(): void;
+export declare function setupCompositePreprocessor(): void;
+//# sourceMappingURL=preprocessor-usage.d.ts.map

package/dist/examples/preprocessor-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preprocessor-usage.d.ts","sourceRoot":"","sources":["../../examples/preprocessor-usage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEL,KAAK,mBAAmB,EAGzB,MAAM,2BAA2B,CAAC;AA4HnC,wBAAgB,kBAAkB,IAAI,IAAI,CAiCzC;AAMD,wBAAgB,YAAY,IAAI,IAAI,CAYnC;AAMD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,mBAAmB,CAoBrB;AAGD,wBAAgB,wBAAwB,IAAI,IAAI,CAY/C;AA8BD,wBAAgB,0BAA0B,IAAI,IAAI,CAQjD"}