proxy-api-mcp 1.0.0

package/dist/src/tools/validator.js

@@ -0,0 +1,133 @@
+/**
+ * Schema 验证器
+ */
+import { z, ZodError } from 'zod';
+import { SchemaValidationError } from '../utils/errors.js';
+import { logger } from '../utils/logger.js';
+/**
+ * JSON Schema 转 Zod Schema 的辅助函数
+ */
+export class SchemaValidator {
+    /**
+     * 从 JSON Schema 创建 Zod Schema
+     * 注意:这是一个简化的实现,仅支持基本类型
+     */
+    static createZodSchema(jsonSchema) {
+        const type = jsonSchema.type;
+        switch (type) {
+            case 'object': {
+                const properties = jsonSchema.properties || {};
+                const required = jsonSchema.required || [];
+                const shape = {};
+                for (const [key, prop] of Object.entries(properties)) {
+                    const propSchema = this.createZodSchema(prop);
+                    shape[key] = required.includes(key) ? propSchema : propSchema.optional();
+                }
+                return z.object(shape);
+            }
+            case 'array': {
+                const items = jsonSchema.items;
+                if (items) {
+                    return z.array(this.createZodSchema(items));
+                }
+                return z.array(z.unknown());
+            }
+            case 'string': {
+                let schema = z.string();
+                if (jsonSchema.minLength) {
+                    schema = schema.min(jsonSchema.minLength);
+                }
+                if (jsonSchema.maxLength) {
+                    schema = schema.max(jsonSchema.maxLength);
+                }
+                if (jsonSchema.pattern) {
+                    schema = schema.regex(new RegExp(jsonSchema.pattern));
+                }
+                if (jsonSchema.format === 'email') {
+                    schema = schema.email();
+                }
+                if (jsonSchema.format === 'url' || jsonSchema.format === 'uri') {
+                    schema = schema.url();
+                }
+                return schema;
+            }
+            case 'number':
+            case 'integer': {
+                let schema = type === 'integer' ? z.number().int() : z.number();
+                if (jsonSchema.minimum !== undefined) {
+                    schema = schema.min(jsonSchema.minimum);
+                }
+                if (jsonSchema.maximum !== undefined) {
+                    schema = schema.max(jsonSchema.maximum);
+                }
+                return schema;
+            }
+            case 'boolean':
+                return z.boolean();
+            default:
+                // 对于未知类型,使用 any
+                logger.warn(`Unknown schema type: ${type}, using z.any()`);
+                return z.any();
+        }
+    }
+    /**
+     * 验证输入数据
+     */
+    static validateInput(data, schema) {
+        try {
+            const zodSchema = this.createZodSchema(schema);
+            return zodSchema.parse(data);
+        }
+        catch (error) {
+            if (error instanceof ZodError) {
+                const errors = error.errors.map(e => ({
+                    path: e.path.join('.'),
+                    message: e.message,
+                    code: e.code,
+                }));
+                throw new SchemaValidationError(`Input validation failed: ${errors.map(e => e.message).join(', ')}`, errors);
+            }
+            throw error;
+        }
+    }
+    /**
+     * 验证输出数据(宽松模式,只记录警告)
+     */
+    static validateOutput(data, schema) {
+        try {
+            const zodSchema = this.createZodSchema(schema);
+            zodSchema.parse(data);
+            return true;
+        }
+        catch (error) {
+            if (error instanceof ZodError) {
+                const errors = error.errors.map(e => ({
+                    path: e.path.join('.'),
+                    message: e.message,
+                }));
+                logger.warn('Output validation failed', { errors });
+                return false;
+            }
+            logger.warn('Output validation error', { error });
+            return false;
+        }
+    }
+    /**
+     * 验证 JSON Schema 本身的有效性
+     */
+    static isValidSchema(schema) {
+        try {
+            // 基本检查
+            if (!schema.type) {
+                return false;
+            }
+            // 尝试创建 Zod Schema
+            this.createZodSchema(schema);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/src/tools/validator.js.map

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

package/dist/src/utils/cache.d.ts

@@ -0,0 +1,14 @@
+export interface CacheContent<T> {
+    value: T;
+    createTime: number;
+}
+export declare class CACHE<T> {
+    content: Map<string, CacheContent<T>>;
+    maxTime: number;
+    constructor(maxTime?: number);
+    set(key: string, value: T): T | null;
+    _isExpired(content: CacheContent<T>): boolean;
+    get(key: string): T | null;
+    remove(key: string): void;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/src/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/utils/cache.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC;IACT,UAAU,EAAE,MAAM,CAAA;CACrB;AAGD,qBAAa,KAAK,CAAC,CAAC;IAChB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;IACrC,OAAO,SAAO;gBACF,OAAO,CAAC,EAAE,MAAM;IAQ5B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI;IAQpC,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO;IAU7C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAc1B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAI5B"}

package/dist/src/utils/cache.js

@@ -0,0 +1,42 @@
+export class CACHE {
+    content;
+    maxTime = 3000;
+    constructor(maxTime) {
+        if (maxTime) {
+            this.maxTime = maxTime;
+        }
+        this.content = new Map();
+    }
+    set(key, value) {
+        this.content.set(key, {
+            value,
+            createTime: new Date().getTime()
+        });
+        return this.get(key);
+    }
+    _isExpired(content) {
+        const now = new Date().getTime();
+        if (content) {
+            if (now - content.createTime > this.maxTime) {
+                return true;
+            }
+        }
+        return false;
+    }
+    get(key) {
+        const content = this.content.get(key);
+        if (content) {
+            if (this._isExpired(content)) {
+                return null;
+            }
+            else {
+                return content.value;
+            }
+        }
+        return null;
+    }
+    remove(key) {
+        this.content.delete(key);
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/src/utils/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/utils/cache.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,KAAK;IACd,OAAO,CAA8B;IACrC,OAAO,GAAG,IAAI,CAAA;IACd,YAAY,OAAgB;QACxB,IAAI,OAAO,EAAE,CAAC;YACV,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QAC1B,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,EAAE,CAAA;IAC5B,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,KAAQ;QACrB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE;YAClB,KAAK;YACL,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE;SACnC,CAAC,CAAA;QACF,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAExB,CAAC;IACD,UAAU,CAAC,OAAwB;QAC/B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,CAAA;QAChC,IAAI,OAAO,EAAE,CAAC;YACV,IAAI,GAAG,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC1C,OAAO,IAAI,CAAA;YACf,CAAC;QACL,CAAC;QACD,OAAO,KAAK,CAAA;IAEhB,CAAC;IACD,GAAG,CAAC,GAAW;QACX,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACrC,IAAI,OAAO,EAAE,CAAC;YACV,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3B,OAAO,IAAI,CAAA;YACf,CAAC;iBAAM,CAAC;gBACJ,OAAO,OAAO,CAAC,KAAK,CAAA;YAExB,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAA;IAGf,CAAC;IACD,MAAM,CAAC,GAAW;QACd,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAC5B,CAAC;CAEJ"}

package/dist/src/utils/env-replacer.d.ts

@@ -0,0 +1,86 @@
+/**
+ * 环境变量替换工具
+ *
+ * 支持在 JSON 配置中使用环境变量占位符:
+ * - ${VAR_NAME} - 使用环境变量,如果不存在则抛出错误
+ * - ${VAR_NAME:default} - 使用环境变量,如果不存在则使用默认值
+ *
+ * 使用示例:
+ * ```typescript
+ * const result = replaceEnvVariables({
+ *   baseUrl: "${API_BASE_URL:https://api.example.com}",
+ *   token: "${API_TOKEN}"
+ * });
+ * ```
+ */
+/**
+ * 环境变量替换错误
+ */
+export declare class EnvReplacementError extends Error {
+    readonly variable: string;
+    readonly path?: string | undefined;
+    constructor(message: string, variable: string, path?: string | undefined);
+}
+/**
+ * 替换选项
+ */
+export interface ReplaceOptions {
+    /** 是否允许未定义的环境变量(如果为 true,未定义的变量将保持原样) */
+    allowUndefined?: boolean;
+    /** 当前处理的路径(用于错误提示) */
+    path?: string;
+    /** 自定义环境变量源(默认使用 process.env) */
+    env?: Record<string, string | undefined>;
+}
+/**
+ * 替换字符串中的环境变量占位符
+ *
+ * @param str - 包含占位符的字符串
+ * @param options - 替换选项
+ * @returns 替换后的字符串
+ * @throws EnvReplacementError 如果必需的环境变量不存在
+ */
+export declare function replaceEnvInString(str: string, options?: ReplaceOptions): string;
+/**
+ * 递归替换对象中所有字符串值的环境变量
+ *
+ * @param obj - 要处理的对象
+ * @param options - 替换选项
+ * @returns 替换后的对象(会修改原对象)
+ */
+export declare function replaceEnvVariables<T>(obj: T, options?: ReplaceOptions): T;
+/**
+ * 验证字符串中是否包含环境变量占位符
+ *
+ * @param str - 要检查的字符串
+ * @returns 是否包含环境变量占位符
+ */
+export declare function hasEnvPlaceholder(str: string): boolean;
+/**
+ * 提取字符串中所有的环境变量名称
+ *
+ * @param str - 要分析的字符串
+ * @returns 环境变量名称数组
+ */
+export declare function extractEnvVariables(str: string): string[];
+/**
+ * 验证对象中所有必需的环境变量是否已定义
+ *
+ * @param obj - 要验证的对象
+ * @param options - 验证选项
+ * @returns 验证结果 { valid: boolean, missing: string[] }
+ */
+export declare function validateEnvVariables(obj: unknown, options?: ReplaceOptions): {
+    valid: boolean;
+    missing: string[];
+};
+/**
+ * 类型转换辅助函数
+ * 根据原始值的类型转换环境变量值
+ *
+ * @param value - 环境变量值(字符串)
+ * @param originalType - 原始值的类型
+ * @returns 转换后的值
+ */
+export declare function convertEnvValue(value: string, originalType: unknown): unknown;
+//# sourceMappingURL=env-replacer.d.ts.map

package/dist/src/utils/env-replacer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-replacer.d.ts","sourceRoot":"","sources":["../../../src/utils/env-replacer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAUH;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAG1B,QAAQ,EAAE,MAAM;aAChB,IAAI,CAAC,EAAE,MAAM;gBAF7B,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,YAAA;CAKhC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,cAAmB,GAC3B,MAAM,CA8BR;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,GAAG,EAAE,CAAC,EACN,OAAO,GAAE,cAAmB,GAC3B,CAAC,CAsCH;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAUzD;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,cAAmB,GAC3B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAsCvC;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAgB7E"}

package/dist/src/utils/env-replacer.js

@@ -0,0 +1,196 @@
+/**
+ * 环境变量替换工具
+ *
+ * 支持在 JSON 配置中使用环境变量占位符:
+ * - ${VAR_NAME} - 使用环境变量,如果不存在则抛出错误
+ * - ${VAR_NAME:default} - 使用环境变量,如果不存在则使用默认值
+ *
+ * 使用示例:
+ * ```typescript
+ * const result = replaceEnvVariables({
+ *   baseUrl: "${API_BASE_URL:https://api.example.com}",
+ *   token: "${API_TOKEN}"
+ * });
+ * ```
+ */
+import { logger } from './logger.js';
+/**
+ * 环境变量占位符的正则表达式
+ * 匹配格式: ${VAR_NAME} 或 ${VAR_NAME:default_value}
+ */
+const ENV_PATTERN = /\$\{([^}:]+)(?::([^}]*))?\}/g;
+/**
+ * 环境变量替换错误
+ */
+export class EnvReplacementError extends Error {
+    variable;
+    path;
+    constructor(message, variable, path) {
+        super(message);
+        this.variable = variable;
+        this.path = path;
+        this.name = 'EnvReplacementError';
+    }
+}
+/**
+ * 替换字符串中的环境变量占位符
+ *
+ * @param str - 包含占位符的字符串
+ * @param options - 替换选项
+ * @returns 替换后的字符串
+ * @throws EnvReplacementError 如果必需的环境变量不存在
+ */
+export function replaceEnvInString(str, options = {}) {
+    const { allowUndefined = false, path = '', env = process.env } = options;
+    return str.replace(ENV_PATTERN, (match, varName, defaultValue) => {
+        const envValue = env[varName];
+        // 如果环境变量存在,直接使用
+        if (envValue !== undefined) {
+            return envValue;
+        }
+        // 如果有默认值,使用默认值
+        if (defaultValue !== undefined) {
+            logger.debug(`Using default value for ${varName}: ${defaultValue}`, { path });
+            return defaultValue;
+        }
+        // 如果允许未定义,保持原样
+        if (allowUndefined) {
+            logger.warn(`Environment variable ${varName} is not defined, keeping placeholder`, { path });
+            return match;
+        }
+        // 否则抛出错误
+        throw new EnvReplacementError(`Environment variable ${varName} is not defined and no default value provided`, varName, path);
+    });
+}
+/**
+ * 递归替换对象中所有字符串值的环境变量
+ *
+ * @param obj - 要处理的对象
+ * @param options - 替换选项
+ * @returns 替换后的对象(会修改原对象)
+ */
+export function replaceEnvVariables(obj, options = {}) {
+    if (obj === null || obj === undefined) {
+        return obj;
+    }
+    // 处理字符串
+    if (typeof obj === 'string') {
+        return replaceEnvInString(obj, options);
+    }
+    // 处理数组
+    if (Array.isArray(obj)) {
+        return obj.map((item, index) => 
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+        replaceEnvVariables(item, {
+            ...options,
+            path: options.path ? `${options.path}[${index}]` : `[${index}]`
+        }));
+    }
+    // 处理对象
+    if (typeof obj === 'object') {
+        const result = { ...obj };
+        for (const key in result) {
+            if (Object.prototype.hasOwnProperty.call(result, key)) {
+                const newPath = options.path ? `${options.path}.${key}` : key;
+                result[key] = replaceEnvVariables(result[key], {
+                    ...options,
+                    path: newPath
+                });
+            }
+        }
+        return result;
+    }
+    // 其他类型直接返回
+    return obj;
+}
+/**
+ * 验证字符串中是否包含环境变量占位符
+ *
+ * @param str - 要检查的字符串
+ * @returns 是否包含环境变量占位符
+ */
+export function hasEnvPlaceholder(str) {
+    return ENV_PATTERN.test(str);
+}
+/**
+ * 提取字符串中所有的环境变量名称
+ *
+ * @param str - 要分析的字符串
+ * @returns 环境变量名称数组
+ */
+export function extractEnvVariables(str) {
+    const variables = [];
+    const regex = new RegExp(ENV_PATTERN);
+    let match;
+    while ((match = regex.exec(str)) !== null) {
+        variables.push(match[1]);
+    }
+    return variables;
+}
+/**
+ * 验证对象中所有必需的环境变量是否已定义
+ *
+ * @param obj - 要验证的对象
+ * @param options - 验证选项
+ * @returns 验证结果 { valid: boolean, missing: string[] }
+ */
+export function validateEnvVariables(obj, options = {}) {
+    const { env = process.env } = options;
+    const missing = new Set();
+    function scan(value, path = '') {
+        if (typeof value === 'string') {
+            const regex = new RegExp(ENV_PATTERN);
+            let match;
+            while ((match = regex.exec(value)) !== null) {
+                const varName = match[1];
+                const hasDefault = match[2] !== undefined;
+                // 只检查没有默认值的环境变量
+                if (!hasDefault && env[varName] === undefined) {
+                    missing.add(varName);
+                }
+            }
+        }
+        else if (Array.isArray(value)) {
+            value.forEach((item, index) => {
+                scan(item, path ? `${path}[${index}]` : `[${index}]`);
+            });
+        }
+        else if (value !== null && typeof value === 'object') {
+            for (const key in value) {
+                if (Object.prototype.hasOwnProperty.call(value, key)) {
+                    const newPath = path ? `${path}.${key}` : key;
+                    scan(value[key], newPath);
+                }
+            }
+        }
+    }
+    scan(obj);
+    return {
+        valid: missing.size === 0,
+        missing: Array.from(missing)
+    };
+}
+/**
+ * 类型转换辅助函数
+ * 根据原始值的类型转换环境变量值
+ *
+ * @param value - 环境变量值(字符串)
+ * @param originalType - 原始值的类型
+ * @returns 转换后的值
+ */
+export function convertEnvValue(value, originalType) {
+    // 如果原始值是数字,尝试转换为数字
+    if (typeof originalType === 'number') {
+        const num = Number(value);
+        if (!isNaN(num)) {
+            return num;
+        }
+    }
+    // 如果原始值是布尔值,转换为布尔值
+    if (typeof originalType === 'boolean') {
+        return value.toLowerCase() === 'true' || value === '1';
+    }
+    // 默认返回字符串
+    return value;
+}
+//# sourceMappingURL=env-replacer.js.map

package/dist/src/utils/env-replacer.js.map

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

package/dist/src/utils/errors.d.ts

@@ -0,0 +1,102 @@
+/**
+ * 错误定义
+ */
+/**
+ * MCP 错误基类
+ */
+export declare class McpError extends Error {
+    code: number;
+    data?: unknown | undefined;
+    constructor(message: string, code: number, data?: unknown | undefined);
+    /**
+     * 转换为 JSON-RPC 错误对象
+     */
+    toJSON(): {
+        code: number;
+        message: string;
+        data: unknown;
+    };
+}
+/**
+ * 解析错误 (-32700)
+ */
+export declare class ParseError extends McpError {
+    constructor(message?: string, data?: unknown);
+}
+/**
+ * 无效请求 (-32600)
+ */
+export declare class InvalidRequestError extends McpError {
+    constructor(message?: string, data?: unknown);
+}
+/**
+ * 方法不存在 (-32601)
+ */
+export declare class MethodNotFoundError extends McpError {
+    constructor(message?: string, data?: unknown);
+}
+/**
+ * 无效参数 (-32602)
+ */
+export declare class InvalidParamsError extends McpError {
+    constructor(message?: string, data?: unknown);
+}
+/**
+ * 内部错误 (-32603)
+ */
+export declare class InternalError extends McpError {
+    constructor(message?: string, data?: unknown);
+}
+/**
+ * 工具不存在错误 (-32000)
+ */
+export declare class ToolNotFoundError extends McpError {
+    constructor(toolName: string);
+}
+/**
+ * 工具执行错误 (-32001)
+ */
+export declare class ToolExecutionError extends McpError {
+    constructor(toolName: string, originalError: Error);
+}
+/**
+ * Schema 验证错误 (-32002)
+ */
+export declare class SchemaValidationError extends McpError {
+    constructor(message: string, errors: unknown);
+}
+/**
+ * 会话不存在错误 (-32003)
+ */
+export declare class SessionNotFoundError extends McpError {
+    constructor(sessionId: string);
+}
+/**
+ * 会话超时错误 (-32004)
+ */
+export declare class SessionTimeoutError extends McpError {
+    constructor(sessionId: string);
+}
+/**
+ * 工具注册错误 (-32005)
+ */
+export declare class ToolRegistrationError extends McpError {
+    constructor(message: string, data?: unknown);
+}
+/**
+ * 配置错误 (-32006)
+ */
+export declare class ConfigurationError extends McpError {
+    constructor(message: string, data?: unknown);
+}
+/**
+ * 速率限制错误 (-32007)
+ */
+export declare class RateLimitError extends McpError {
+    constructor(message?: string, data?: unknown);
+}
+/**
+ * 将任意错误转换为 McpError
+ */
+export declare function toMcpError(error: unknown): McpError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IAGxB,IAAI,EAAE,MAAM;IACZ,IAAI,CAAC,EAAE,OAAO;gBAFrB,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,YAAA;IAOvB;;OAEG;IACH,MAAM;;;;;CAOP;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,QAAQ;gBAC1B,OAAO,SAAgB,EAAE,IAAI,CAAC,EAAE,OAAO;CAIpD;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,OAAO,SAAoB,EAAE,IAAI,CAAC,EAAE,OAAO;CAIxD;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,OAAO,SAAqB,EAAE,IAAI,CAAC,EAAE,OAAO;CAIzD;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,OAAO,SAAmB,EAAE,IAAI,CAAC,EAAE,OAAO;CAIvD;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,OAAO,SAAmB,EAAE,IAAI,CAAC,EAAE,OAAO;CAIvD;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,QAAQ;gBACjC,QAAQ,EAAE,MAAM;CAI7B;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK;CAYnD;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,QAAQ;gBACrC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO;CAI7C;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,QAAQ;gBACpC,SAAS,EAAE,MAAM;CAI9B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,SAAS,EAAE,MAAM;CAI9B;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,QAAQ;gBACrC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAI5C;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAI5C;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,OAAO,SAAwB,EAAE,IAAI,CAAC,EAAE,OAAO;CAI5D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAanD"}