@machina.ai/openapi-contract-tester 2.1.0

package/dist/llm/data-generator-ai.js

@@ -0,0 +1,284 @@
+/**
+ * AI-Powered Data Generator
+ *
+ * Generates contextual, realistic test data using LLM.
+ * Used as a fallback when Faker data is not appropriate for the API domain.
+ *
+ * @module llm/data-generator-ai
+ */
+import { callLLM } from './ai-client.js';
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('data-generator-ai');
+/**
+ * Checks if an endpoint is critical and requires AI-generated data
+ *
+ * @param context - API context
+ * @returns true if endpoint is critical
+ */
+export function isCriticalEndpoint(context) {
+    if (!context?.endpoint)
+        return false;
+    const criticalPaths = [
+        'login',
+        'auth',
+        'payment',
+        'transfer',
+        'password',
+        'register',
+        'signup',
+        'checkout',
+        'transaction',
+        'account',
+        'wallet',
+        'balance'
+    ];
+    const endpoint = context.endpoint.toLowerCase();
+    return criticalPaths.some(path => endpoint.includes(path));
+}
+/**
+ * Generates a realistic value using AI based on schema and context
+ *
+ * @param schema - JSON Schema object
+ * @param propertyName - Name of the property being generated
+ * @param context - API context for domain-specific generation
+ * @returns Generated value or null if AI fails
+ */
+export async function generateValueWithAI(schema, propertyName, context) {
+    try {
+        const prompt = buildPromptForValue(schema, propertyName, context);
+        log.debug('Generating value with AI', { propertyName, context });
+        const result = await callLLM(prompt, {
+            maxTokens: 256,
+            temperature: 0.3,
+            timeout: 10000
+        });
+        if (!result.success || !result.text) {
+            log.warn('AI generation failed', { propertyName, error: result.error });
+            return null;
+        }
+        const generatedValue = parseAIValue(result.text.trim(), schema.type);
+        log.debug('AI generated value', { propertyName, value: generatedValue });
+        return generatedValue;
+    }
+    catch (error) {
+        log.error('AI generation error', {
+            propertyName,
+            error: error instanceof Error ? error.message : String(error)
+        });
+        return null;
+    }
+}
+/**
+ * Builds a prompt for generating a single value
+ *
+ * @param schema - JSON Schema object
+ * @param propertyName - Name of the property
+ * @param context - API context
+ * @returns Prompt string
+ */
+function buildPromptForValue(schema, propertyName, context) {
+    const constraints = buildConstraintsDescription(schema);
+    return `Generate realistic test data for an API endpoint.
+
+Property: ${propertyName}
+Type: ${schema.type || 'string'}
+Format: ${schema.format || 'none'}
+${constraints ? `Constraints: ${constraints}\n` : ''}
+API Context:
+- Type: ${context?.type || 'unknown'}
+- Endpoint: ${context?.endpoint || 'unknown'}
+- Purpose: ${context?.purpose || 'general'}
+
+Generate ONE realistic value that:
+1. Matches the schema type and format
+2. Respects all constraints (min, max, pattern, enum)
+3. Is appropriate for the API type (e.g., realistic IBAN for banking ${propertyName})
+4. Would likely exist in a real database for ${context?.type || 'this'} applications
+
+Examples of good values:
+- For "email" in banking API: "john.smith@company.com" (professional)
+- For "amount" in banking API: "150.50" (realistic transaction)
+- For "iban" in banking API: "DE89370400440532013000" (valid IBAN format)
+- For "username" in blog API: "tech_blogger_2024" (casual)
+
+Respond with ONLY the value, no explanation, no quotes unless it's a string that needs them.`;
+}
+/**
+ * Builds a description of schema constraints
+ *
+ * @param schema - JSON Schema object
+ * @returns Constraints description
+ */
+function buildConstraintsDescription(schema) {
+    const parts = [];
+    if (schema.minimum !== undefined) {
+        parts.push(`min: ${schema.minimum}`);
+    }
+    if (schema.maximum !== undefined) {
+        parts.push(`max: ${schema.maximum}`);
+    }
+    if (schema.minLength !== undefined) {
+        parts.push(`minLength: ${schema.minLength}`);
+    }
+    if (schema.maxLength !== undefined) {
+        parts.push(`maxLength: ${schema.maxLength}`);
+    }
+    if (schema.pattern) {
+        parts.push(`pattern: ${schema.pattern}`);
+    }
+    if (schema.enum) {
+        parts.push(`enum: [${schema.enum.join(', ')}]`);
+    }
+    return parts.join(', ');
+}
+/**
+ * Parses AI-generated text into the appropriate type
+ *
+ * @param text - AI-generated text
+ * @param schemaType - Expected schema type
+ * @returns Parsed value
+ */
+function parseAIValue(text, schemaType) {
+    // Remove surrounding quotes if present
+    let cleaned = text.trim();
+    if ((cleaned.startsWith('"') && cleaned.endsWith('"')) ||
+        (cleaned.startsWith("'") && cleaned.endsWith("'"))) {
+        cleaned = cleaned.slice(1, -1);
+    }
+    // Parse based on schema type
+    switch (schemaType) {
+        case 'integer':
+            return parseInt(cleaned, 10);
+        case 'number':
+            return parseFloat(cleaned);
+        case 'boolean':
+            return cleaned.toLowerCase() === 'true';
+        case 'array':
+            try {
+                return JSON.parse(text);
+            }
+            catch {
+                // If JSON parse fails, split by comma
+                return cleaned.split(',').map(s => s.trim());
+            }
+        case 'object':
+            try {
+                return JSON.parse(text);
+            }
+            catch {
+                return { value: cleaned };
+            }
+        case 'string':
+        default:
+            return cleaned;
+    }
+}
+/**
+ * Generates intelligent edge case values using AI
+ *
+ * @param schema - JSON Schema object
+ * @param propertyName - Name of the property
+ * @param context - API context
+ * @returns Array of edge case values with descriptions
+ */
+export async function generateEdgeCasesWithAI(schema, propertyName, context) {
+    try {
+        const prompt = `Generate realistic edge case values for API testing.
+
+Property: ${propertyName}
+Type: ${schema.type || 'string'}
+API Type: ${context?.type || 'unknown'}
+Endpoint: ${context?.endpoint || 'unknown'}
+
+Generate 3 edge cases that are realistic for a ${context?.type || 'generic'} API:
+1. A valid edge case (boundary value that should work)
+2. An invalid edge case (should fail validation)
+3. A domain-specific edge case (specific to ${context?.type || 'this domain'})
+
+Format your response as JSON array:
+[
+  {"value": "...", "description": "...", "expectedStatus": 200},
+  {"value": "...", "description": "...", "expectedStatus": 400},
+  {"value": "...", "description": "...", "expectedStatus": 400}
+]`;
+        const result = await callLLM(prompt, {
+            maxTokens: 512,
+            temperature: 0.4,
+            timeout: 15000
+        });
+        if (!result.success || !result.text) {
+            log.warn('AI edge case generation failed', { propertyName });
+            return [];
+        }
+        // Try to parse JSON response
+        try {
+            const edgeCases = JSON.parse(result.text.trim());
+            if (Array.isArray(edgeCases)) {
+                return edgeCases;
+            }
+        }
+        catch (parseError) {
+            log.warn('Failed to parse AI edge cases', { propertyName, parseError });
+        }
+        return [];
+    }
+    catch (error) {
+        log.error('AI edge case generation error', {
+            propertyName,
+            error: error instanceof Error ? error.message : String(error)
+        });
+        return [];
+    }
+}
+/**
+ * Infers the purpose of an endpoint from its path and method
+ *
+ * @param endpoint - Endpoint path
+ * @param method - HTTP method
+ * @returns Inferred purpose
+ */
+export function inferEndpointPurpose(endpoint, method) {
+    const path = endpoint.toLowerCase();
+    const m = method.toUpperCase();
+    // Authentication
+    if (path.includes('login') || path.includes('signin'))
+        return 'login';
+    if (path.includes('logout') || path.includes('signout'))
+        return 'logout';
+    if (path.includes('register') || path.includes('signup'))
+        return 'register';
+    if (path.includes('auth'))
+        return 'authentication';
+    // Payment & Financial
+    if (path.includes('payment') || path.includes('pay'))
+        return 'payment';
+    if (path.includes('transfer'))
+        return 'transfer';
+    if (path.includes('transaction'))
+        return 'transaction';
+    if (path.includes('balance'))
+        return 'balance_check';
+    if (path.includes('wallet'))
+        return 'wallet_management';
+    // User management
+    if (path.includes('user') || path.includes('profile')) {
+        if (m === 'POST')
+            return 'create_user';
+        if (m === 'PUT' || m === 'PATCH')
+            return 'update_user';
+        if (m === 'DELETE')
+            return 'delete_user';
+        return 'get_user';
+    }
+    // Generic CRUD
+    if (m === 'POST')
+        return 'create';
+    if (m === 'PUT' || m === 'PATCH')
+        return 'update';
+    if (m === 'DELETE')
+        return 'delete';
+    if (m === 'GET')
+        return 'retrieve';
+    return 'general';
+}
+//# sourceMappingURL=data-generator-ai.js.map

package/dist/llm/data-generator-ai.js.map

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

package/dist/llm/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * LLM Module Exports
+ *
+ * @module llm
+ */
+export { callLLM, callLLMWithData, toTOONFormat, isLLMAvailable, getConfiguredAIUrl, type LLMCallOptions, type LLMResult } from './ai-client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/llm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,OAAO,EACP,eAAe,EACf,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC"}

package/dist/llm/index.js

@@ -0,0 +1,7 @@
+/**
+ * LLM Module Exports
+ *
+ * @module llm
+ */
+export { callLLM, callLLMWithData, toTOONFormat, isLLMAvailable, getConfiguredAIUrl } from './ai-client.js';
+//# sourceMappingURL=index.js.map

package/dist/llm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,OAAO,EACP,eAAe,EACf,YAAY,EACZ,cAAc,EACd,kBAAkB,EAGnB,MAAM,gBAAgB,CAAC"}

package/dist/mcp/handlers/base-handler.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Base Handler - Abstract base class for tool handlers
+ *
+ * Provides common functionality for all tool handlers including:
+ * - Logging
+ * - Response formatting
+ * - Error handling
+ *
+ * @module mcp/handlers/base-handler
+ */
+import type { ToolHandler, ToolResponse } from './types.js';
+import { createLogger } from '../../utils/logger.js';
+/**
+ * Abstract base class for tool handlers
+ *
+ * Provides common functionality that all handlers can use.
+ */
+export declare abstract class BaseToolHandler implements ToolHandler {
+    /**
+     * Logger instance for this handler
+     */
+    protected log: ReturnType<typeof createLogger>;
+    /**
+     * Tool name (must be implemented by subclass)
+     */
+    abstract readonly name: string;
+    /**
+     * Tool description (must be implemented by subclass)
+     */
+    abstract readonly description: string;
+    /**
+     * Tool input schema (must be implemented by subclass)
+     */
+    abstract readonly inputSchema: {
+        type: string;
+        properties?: Record<string, unknown>;
+        required?: string[];
+        [key: string]: unknown;
+    };
+    constructor();
+    /**
+     * Handle tool invocation (must be implemented by subclass)
+     *
+     * @param args - Tool arguments
+     * @returns Tool response
+     */
+    abstract handle(args: unknown): Promise<ToolResponse>;
+    /**
+     * Formats a successful response
+     *
+     * @param data - Data to return
+     * @param asJson - Whether to JSON stringify the data (default: true)
+     * @returns Formatted tool response
+     */
+    protected formatResponse(data: unknown, asJson?: boolean): ToolResponse;
+    /**
+     * Formats an error response
+     *
+     * @param error - Error object or message
+     * @returns Formatted error response
+     */
+    protected formatError(error: unknown): ToolResponse;
+    /**
+     * Wraps handler execution with try/catch and logging
+     *
+     * @param fn - Handler function to execute
+     * @param context - Context info for logging
+     * @returns Tool response
+     */
+    protected executeWithErrorHandling<T>(fn: () => Promise<T>, context?: Record<string, unknown>): Promise<ToolResponse>;
+}
+//# sourceMappingURL=base-handler.d.ts.map

package/dist/mcp/handlers/base-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-handler.d.ts","sourceRoot":"","sources":["../../../src/mcp/handlers/base-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGrD;;;;GAIG;AACH,8BAAsB,eAAgB,YAAW,WAAW;IAC1D;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;IAE/C;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAEtC;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE;QAC7B,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;;IAMF;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;IAErD;;;;;;OAMG;IACH,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,UAAO,GAAG,YAAY;IAYpE;;;;;OAKG;IACH,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY;IAsBnD;;;;;;OAMG;cACa,wBAAwB,CAAC,CAAC,EACxC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,YAAY,CAAC;CAWzB"}

package/dist/mcp/handlers/base-handler.js

@@ -0,0 +1,86 @@
+/**
+ * Base Handler - Abstract base class for tool handlers
+ *
+ * Provides common functionality for all tool handlers including:
+ * - Logging
+ * - Response formatting
+ * - Error handling
+ *
+ * @module mcp/handlers/base-handler
+ */
+import { createLogger } from '../../utils/logger.js';
+import { formatError } from '../../utils/errors.js';
+/**
+ * Abstract base class for tool handlers
+ *
+ * Provides common functionality that all handlers can use.
+ */
+export class BaseToolHandler {
+    /**
+     * Logger instance for this handler
+     */
+    log;
+    constructor() {
+        this.log = createLogger(this.constructor.name);
+    }
+    /**
+     * Formats a successful response
+     *
+     * @param data - Data to return
+     * @param asJson - Whether to JSON stringify the data (default: true)
+     * @returns Formatted tool response
+     */
+    formatResponse(data, asJson = true) {
+        const text = asJson ? JSON.stringify(data, null, 2) : String(data);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text
+                }
+            ]
+        };
+    }
+    /**
+     * Formats an error response
+     *
+     * @param error - Error object or message
+     * @returns Formatted error response
+     */
+    formatError(error) {
+        const errorMessage = formatError(error);
+        this.log.error('Handler error', { error: errorMessage });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: errorMessage,
+                        success: false
+                    }, null, 2)
+                }
+            ],
+            isError: true
+        };
+    }
+    /**
+     * Wraps handler execution with try/catch and logging
+     *
+     * @param fn - Handler function to execute
+     * @param context - Context info for logging
+     * @returns Tool response
+     */
+    async executeWithErrorHandling(fn, context) {
+        try {
+            this.log.info('Handler started', context);
+            const result = await fn();
+            this.log.info('Handler completed successfully', context);
+            return this.formatResponse(result);
+        }
+        catch (error) {
+            this.log.error('Handler failed', { ...context, error });
+            return this.formatError(error);
+        }
+    }
+}
+//# sourceMappingURL=base-handler.js.map

package/dist/mcp/handlers/base-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-handler.js","sourceRoot":"","sources":["../../../src/mcp/handlers/base-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,OAAgB,eAAe;IACnC;;OAEG;IACO,GAAG,CAAkC;IAsB/C;QACE,IAAI,CAAC,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;IAUD;;;;;;OAMG;IACO,cAAc,CAAC,IAAa,EAAE,MAAM,GAAG,IAAI;QACnD,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACnE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI;iBACL;aACF;SACF,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACO,WAAW,CAAC,KAAc;QAClC,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;QAEzD,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,KAAK,EAAE,YAAY;wBACnB,OAAO,EAAE,KAAK;qBACf,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACO,KAAK,CAAC,wBAAwB,CACtC,EAAoB,EACpB,OAAiC;QAEjC,IAAI,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gCAAgC,EAAE,OAAO,CAAC,CAAC;YACzD,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,gBAAgB,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACxD,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;CACF"}

package/dist/mcp/handlers/compare-sources.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Compare Sources Handler
+ *
+ * Handles the compare-sources tool which compares OpenAPI spec vs Code vs PRD.
+ *
+ * @module mcp/handlers/compare-sources
+ */
+import { BaseToolHandler } from './base-handler.js';
+import type { ToolResponse } from './types.js';
+import { SpecService } from '../services/spec-service.js';
+import { FileService } from '../services/file-service.js';
+/**
+ * Handler for source comparison tool
+ */
+export declare class CompareSourcesHandler extends BaseToolHandler {
+    private specService;
+    private fileService;
+    readonly name = "compare-sources";
+    readonly description: string;
+    readonly inputSchema: {
+        type: string;
+        properties: {
+            specPath: {
+                type: string;
+                description: string;
+            };
+            codeEndpoints: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                    properties: {
+                        method: {
+                            type: string;
+                            description: string;
+                        };
+                        path: {
+                            type: string;
+                            description: string;
+                        };
+                        sourceFile: {
+                            type: string;
+                            description: string;
+                        };
+                        handlerName: {
+                            type: string;
+                            description: string;
+                        };
+                        requiresAuth: {
+                            type: string;
+                            description: string;
+                        };
+                        parameters: {
+                            type: string;
+                            items: {
+                                type: string;
+                            };
+                            description: string;
+                        };
+                    };
+                    required: string[];
+                };
+            };
+            prdPath: {
+                type: string;
+                description: string;
+            };
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            outputPath: {
+                type: string;
+                description: string;
+            };
+            workingDirectory: {
+                type: string;
+                description: string;
+            };
+            enableSemanticAnalysis: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    constructor(specService: SpecService, fileService: FileService);
+    handle(args: unknown): Promise<ToolResponse>;
+}
+//# sourceMappingURL=compare-sources.d.ts.map

package/dist/mcp/handlers/compare-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-sources.d.ts","sourceRoot":"","sources":["../../../src/mcp/handlers/compare-sources.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAI1D;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,eAAe;IA0FtD,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,WAAW;IA1FrB,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,WAAW,SAQyF;IAE7G,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA2ElB;gBAGQ,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,WAAW;IAK5B,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;CA0GnD"}