@machina.ai/openapi-contract-tester 2.1.0

package/dist/prd/prd-storage.d.ts

@@ -0,0 +1,232 @@
+/**
+ * PRD Storage Module
+ *
+ * Handles saving and loading normalized PRD documents.
+ * The normalized PRD is generated by the LLM and saved here for use
+ * by the test generator.
+ *
+ * @module prd/prd-storage
+ */
+/**
+ * Normalized PRD structure
+ * This structure is generated by the LLM from raw PRD documents
+ */
+export interface NormalizedPrd {
+    /**
+     * Version of the normalized PRD format
+     */
+    version: string;
+    /**
+     * Timestamp when the PRD was normalized
+     */
+    normalizedAt: string;
+    /**
+     * Original source files used to generate this PRD
+     */
+    sources: string[];
+    /**
+     * Project/product information
+     */
+    project: {
+        name: string;
+        description?: string;
+        version?: string;
+    };
+    /**
+     * Features/functionalities described in the PRD
+     */
+    features: PrdFeature[];
+    /**
+     * Business rules extracted from the PRD
+     */
+    businessRules: PrdBusinessRule[];
+    /**
+     * User stories extracted from the PRD
+     */
+    userStories: PrdUserStory[];
+    /**
+     * API requirements extracted from the PRD
+     */
+    apiRequirements: PrdApiRequirement[];
+}
+/**
+ * A feature/functionality in the PRD
+ */
+export interface PrdFeature {
+    /**
+     * Unique identifier for the feature
+     */
+    id: string;
+    /**
+     * Feature name
+     */
+    name: string;
+    /**
+     * Feature description
+     */
+    description: string;
+    /**
+     * Priority (high, medium, low)
+     */
+    priority?: 'high' | 'medium' | 'low';
+    /**
+     * Related endpoints
+     */
+    relatedEndpoints?: string[];
+    /**
+     * Acceptance criteria
+     */
+    acceptanceCriteria?: string[];
+}
+/**
+ * A business rule from the PRD
+ */
+export interface PrdBusinessRule {
+    /**
+     * Unique identifier for the rule
+     */
+    id: string;
+    /**
+     * Rule name/title
+     */
+    name: string;
+    /**
+     * Rule description
+     */
+    description: string;
+    /**
+     * The condition that triggers this rule
+     */
+    condition: string;
+    /**
+     * Expected outcome/action
+     */
+    expectedOutcome: string;
+    /**
+     * Related endpoints
+     */
+    relatedEndpoints?: string[];
+    /**
+     * Example values for testing
+     */
+    examples?: {
+        valid?: unknown[];
+        invalid?: unknown[];
+    };
+}
+/**
+ * A user story from the PRD
+ */
+export interface PrdUserStory {
+    /**
+     * Unique identifier
+     */
+    id: string;
+    /**
+     * User story in "As a... I want... So that..." format
+     */
+    story: string;
+    /**
+     * The actor/user role
+     */
+    actor: string;
+    /**
+     * What the user wants to do
+     */
+    action: string;
+    /**
+     * Why they want to do it
+     */
+    benefit?: string;
+    /**
+     * Acceptance criteria
+     */
+    acceptanceCriteria?: string[];
+    /**
+     * Related endpoints
+     */
+    relatedEndpoints?: string[];
+}
+/**
+ * API-specific requirement from the PRD
+ */
+export interface PrdApiRequirement {
+    /**
+     * Unique identifier
+     */
+    id: string;
+    /**
+     * Endpoint path pattern
+     */
+    endpoint?: string;
+    /**
+     * HTTP method
+     */
+    method?: string;
+    /**
+     * Description of the requirement
+     */
+    description: string;
+    /**
+     * Expected request format
+     */
+    expectedRequest?: {
+        headers?: Record<string, string>;
+        body?: Record<string, unknown>;
+    };
+    /**
+     * Expected response
+     */
+    expectedResponse?: {
+        status?: number;
+        body?: Record<string, unknown>;
+    };
+    /**
+     * Validation rules for this endpoint
+     */
+    validations?: string[];
+}
+/**
+ * Saves a normalized PRD to a file
+ *
+ * @param prd - Normalized PRD to save
+ * @param outputPath - Path to save the PRD (default: ./standard_prd.json)
+ * @returns Path where the PRD was saved
+ *
+ * @example
+ * ```typescript
+ * const prd: NormalizedPrd = { ... };
+ * const savedPath = await savePrd(prd, './output/prd.json');
+ * ```
+ */
+export declare function savePrd(prd: NormalizedPrd, outputPath?: string): Promise<string>;
+/**
+ * Loads a normalized PRD from a file
+ *
+ * @param filePath - Path to the normalized PRD file
+ * @returns Normalized PRD
+ *
+ * @example
+ * ```typescript
+ * const prd = await loadPrd('./standard_prd.json');
+ * console.log(prd.businessRules.length);
+ * ```
+ */
+export declare function loadPrd(filePath: string): Promise<NormalizedPrd>;
+/**
+ * Validates a normalized PRD structure
+ *
+ * @param prd - PRD to validate
+ * @returns Validation result
+ */
+export declare function validatePrd(prd: unknown): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Creates an empty normalized PRD template
+ *
+ * @returns Empty normalized PRD structure
+ */
+export declare function createEmptyPrd(): NormalizedPrd;
+//# sourceMappingURL=prd-storage.d.ts.map

package/dist/prd/prd-storage.d.ts.map

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

package/dist/prd/prd-storage.js

@@ -0,0 +1,129 @@
+/**
+ * PRD Storage Module
+ *
+ * Handles saving and loading normalized PRD documents.
+ * The normalized PRD is generated by the LLM and saved here for use
+ * by the test generator.
+ *
+ * @module prd/prd-storage
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('prd-storage');
+/**
+ * Saves a normalized PRD to a file
+ *
+ * @param prd - Normalized PRD to save
+ * @param outputPath - Path to save the PRD (default: ./standard_prd.json)
+ * @returns Path where the PRD was saved
+ *
+ * @example
+ * ```typescript
+ * const prd: NormalizedPrd = { ... };
+ * const savedPath = await savePrd(prd, './output/prd.json');
+ * ```
+ */
+export async function savePrd(prd, outputPath = './standard_prd.json') {
+    log.debug('Saving normalized PRD', { outputPath });
+    // Ensure directory exists
+    const dir = path.dirname(outputPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    // Add metadata
+    const prdWithMeta = {
+        ...prd,
+        version: prd.version || '1.0.0',
+        normalizedAt: prd.normalizedAt || new Date().toISOString(),
+    };
+    // Write file
+    fs.writeFileSync(outputPath, JSON.stringify(prdWithMeta, null, 2), 'utf-8');
+    log.info('Normalized PRD saved', {
+        outputPath,
+        features: prd.features.length,
+        businessRules: prd.businessRules.length,
+        userStories: prd.userStories.length,
+        apiRequirements: prd.apiRequirements.length,
+    });
+    return outputPath;
+}
+/**
+ * Loads a normalized PRD from a file
+ *
+ * @param filePath - Path to the normalized PRD file
+ * @returns Normalized PRD
+ *
+ * @example
+ * ```typescript
+ * const prd = await loadPrd('./standard_prd.json');
+ * console.log(prd.businessRules.length);
+ * ```
+ */
+export async function loadPrd(filePath) {
+    log.debug('Loading normalized PRD', { filePath });
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`Normalized PRD file not found: ${filePath}`);
+    }
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const prd = JSON.parse(content);
+    log.info('Normalized PRD loaded', {
+        filePath,
+        features: prd.features?.length || 0,
+        businessRules: prd.businessRules?.length || 0,
+        userStories: prd.userStories?.length || 0,
+        apiRequirements: prd.apiRequirements?.length || 0,
+    });
+    return prd;
+}
+/**
+ * Validates a normalized PRD structure
+ *
+ * @param prd - PRD to validate
+ * @returns Validation result
+ */
+export function validatePrd(prd) {
+    const errors = [];
+    if (!prd || typeof prd !== 'object') {
+        return { valid: false, errors: ['PRD must be an object'] };
+    }
+    const p = prd;
+    // Check required fields
+    if (!p.project || typeof p.project !== 'object') {
+        errors.push('Missing or invalid "project" field');
+    }
+    if (!Array.isArray(p.features)) {
+        errors.push('Missing or invalid "features" array');
+    }
+    if (!Array.isArray(p.businessRules)) {
+        errors.push('Missing or invalid "businessRules" array');
+    }
+    if (!Array.isArray(p.userStories)) {
+        errors.push('Missing or invalid "userStories" array');
+    }
+    if (!Array.isArray(p.apiRequirements)) {
+        errors.push('Missing or invalid "apiRequirements" array');
+    }
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Creates an empty normalized PRD template
+ *
+ * @returns Empty normalized PRD structure
+ */
+export function createEmptyPrd() {
+    return {
+        version: '1.0.0',
+        normalizedAt: new Date().toISOString(),
+        sources: [],
+        project: {
+            name: '',
+            description: '',
+        },
+        features: [],
+        businessRules: [],
+        userStories: [],
+        apiRequirements: [],
+    };
+}
+//# sourceMappingURL=prd-storage.js.map

package/dist/prd/prd-storage.js.map

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

package/dist/repairers/test-auto-repairer.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Test Auto-Repairer
+ *
+ * Analyzes test failures and suggests automatic repairs for common issues.
+ * Focuses on:
+ * - Missing authentication dependencies
+ * - Missing resource dependencies
+ * - Schema validation errors
+ *
+ * @module repairers/test-auto-repairer
+ */
+import type { TestCase, TestResult, ParsedEndpoint } from '../types/index.js';
+/**
+ * Type of repair needed
+ */
+export type RepairType = 'add_auth_dependency' | 'add_resource_dependency' | 'fix_schema_validation' | 'fix_request_body';
+/**
+ * Repair suggestion for a failed test
+ */
+export interface TestRepair {
+    testId: string;
+    type: RepairType;
+    description: string;
+    confidence: 'high' | 'medium' | 'low';
+    fix: {
+        addDependency?: string;
+        extractId?: string;
+        injectId?: string;
+        newBody?: unknown;
+        reason: string;
+    };
+}
+/**
+ * Result of repair analysis
+ */
+export interface RepairResult {
+    repairs: TestRepair[];
+    summary: {
+        total: number;
+        repairable: number;
+        byType: Record<RepairType, number>;
+    };
+}
+/**
+ * Analyzes failed tests and suggests repairs
+ *
+ * @param failedResults - Array of failed test results
+ * @param allTests - All test cases
+ * @param endpoints - Parsed endpoints
+ * @returns Repair suggestions
+ */
+export declare function analyzeAndRepair(failedResults: TestResult[], allTests: TestCase[], endpoints: ParsedEndpoint[]): Promise<RepairResult>;
+/**
+ * Applies repairs to test cases
+ *
+ * @param tests - Original test cases
+ * @param repairs - Repairs to apply
+ * @returns Updated test cases
+ */
+export declare function applyRepairs(tests: TestCase[], repairs: TestRepair[]): TestCase[];
+//# sourceMappingURL=test-auto-repairer.d.ts.map

package/dist/repairers/test-auto-repairer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-auto-repairer.d.ts","sourceRoot":"","sources":["../../src/repairers/test-auto-repairer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAM9E;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,qBAAqB,GACrB,yBAAyB,GACzB,uBAAuB,GACvB,kBAAkB,CAAC;AAEvB;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,GAAG,EAAE;QACH,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;KACpC,CAAC;CACH;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,aAAa,EAAE,UAAU,EAAE,EAC3B,QAAQ,EAAE,QAAQ,EAAE,EACpB,SAAS,EAAE,cAAc,EAAE,GAC1B,OAAO,CAAC,YAAY,CAAC,CAkCvB;AA4JD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,QAAQ,EAAE,EACjB,OAAO,EAAE,UAAU,EAAE,GACpB,QAAQ,EAAE,CA2BZ"}

package/dist/repairers/test-auto-repairer.js

@@ -0,0 +1,213 @@
+/**
+ * Test Auto-Repairer
+ *
+ * Analyzes test failures and suggests automatic repairs for common issues.
+ * Focuses on:
+ * - Missing authentication dependencies
+ * - Missing resource dependencies
+ * - Schema validation errors
+ *
+ * @module repairers/test-auto-repairer
+ */
+import { callLLM } from '../llm/ai-client.js';
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('test-auto-repairer');
+/**
+ * Analyzes failed tests and suggests repairs
+ *
+ * @param failedResults - Array of failed test results
+ * @param allTests - All test cases
+ * @param endpoints - Parsed endpoints
+ * @returns Repair suggestions
+ */
+export async function analyzeAndRepair(failedResults, allTests, endpoints) {
+    log.info('Analyzing failed tests for auto-repair', {
+        failedCount: failedResults.length
+    });
+    const repairs = [];
+    for (const result of failedResults) {
+        const repair = await suggestRepair(result, allTests, endpoints);
+        if (repair) {
+            repairs.push(repair);
+        }
+    }
+    // Build summary
+    const byType = {};
+    for (const repair of repairs) {
+        byType[repair.type] = (byType[repair.type] || 0) + 1;
+    }
+    log.info('Auto-repair analysis complete', {
+        total: failedResults.length,
+        repairable: repairs.length,
+        byType
+    });
+    return {
+        repairs,
+        summary: {
+            total: failedResults.length,
+            repairable: repairs.length,
+            byType: byType
+        }
+    };
+}
+/**
+ * Suggests a repair for a single failed test
+ *
+ * @param result - Failed test result
+ * @param allTests - All test cases
+ * @param endpoints - Parsed endpoints
+ * @returns Repair suggestion or null
+ */
+async function suggestRepair(result, allTests, endpoints) {
+    const { testCase, actualStatus, error } = result;
+    // Repair 1: Authentication failure (401/403)
+    if (actualStatus === 401 || actualStatus === 403) {
+        return {
+            testId: testCase.id,
+            type: 'add_auth_dependency',
+            description: 'Test requires authentication but has no auth dependency',
+            confidence: 'high',
+            fix: {
+                addDependency: 'login-success',
+                reason: 'Test received 401/403, needs authentication'
+            }
+        };
+    }
+    // Repair 2: Resource not found (404) - add creation dependency
+    if (actualStatus === 404 && testCase.method !== 'POST') {
+        const createTest = findCreateTest(testCase, allTests);
+        if (createTest) {
+            return {
+                testId: testCase.id,
+                type: 'add_resource_dependency',
+                description: `Resource not found, needs to be created first`,
+                confidence: 'high',
+                fix: {
+                    addDependency: createTest.id,
+                    extractId: 'response.body.id',
+                    injectId: `path:${testCase.path}`,
+                    reason: `Resource doesn't exist, must create via ${createTest.path}`
+                }
+            };
+        }
+    }
+    // Repair 3: Schema validation or bad request (400)
+    if (actualStatus === 400) {
+        // Try to fix with AI
+        const endpoint = endpoints.find(e => e.path === testCase.path && e.method === testCase.method);
+        if (endpoint && testCase.body) {
+            const fixedBody = await fixRequestBodyWithAI(testCase, endpoint, error);
+            if (fixedBody) {
+                return {
+                    testId: testCase.id,
+                    type: 'fix_schema_validation',
+                    description: 'Request body does not match schema',
+                    confidence: 'medium',
+                    fix: {
+                        newBody: fixedBody,
+                        reason: 'AI corrected request body to match schema'
+                    }
+                };
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Finds the corresponding creation test for a resource
+ *
+ * @param testCase - Test that needs a resource
+ * @param allTests - All test cases
+ * @returns Creation test or null
+ */
+function findCreateTest(testCase, allTests) {
+    // Extract base path (without parameters)
+    const basePath = testCase.path.replace(/\/\{[^}]+\}.*$/, '');
+    // Find POST test to the base path
+    const createTests = allTests.filter(t => t.method === 'POST' &&
+        t.path === basePath &&
+        t.category === 'happy-path' &&
+        t.expectedStatus >= 200 &&
+        t.expectedStatus < 300);
+    return createTests.length > 0 ? createTests[0] : null;
+}
+/**
+ * Uses AI to fix a request body that failed validation
+ *
+ * @param testCase - Failed test case
+ * @param endpoint - Endpoint information
+ * @param error - Error message
+ * @returns Fixed body or null
+ */
+async function fixRequestBodyWithAI(testCase, endpoint, error) {
+    try {
+        const prompt = `Fix this API request body to match the schema.
+
+Endpoint: ${testCase.method} ${testCase.path}
+Current body: ${JSON.stringify(testCase.body, null, 2)}
+Expected schema: ${JSON.stringify(endpoint.requestBody, null, 2)}
+Error: ${error || 'Schema validation failed'}
+
+Respond with ONLY the fixed JSON body, no explanation.`;
+        log.debug('Attempting AI body fix', { testId: testCase.id });
+        const result = await callLLM(prompt, {
+            maxTokens: 512,
+            temperature: 0.2,
+            timeout: 10000
+        });
+        if (result.success && result.text) {
+            // Clean response (remove markdown if present)
+            let cleaned = result.text.trim();
+            if (cleaned.startsWith('```')) {
+                cleaned = cleaned.replace(/^```(?:json)?\n/, '').replace(/\n```$/, '');
+            }
+            try {
+                const fixedBody = JSON.parse(cleaned);
+                log.info('AI successfully fixed request body', { testId: testCase.id });
+                return fixedBody;
+            }
+            catch (parseError) {
+                log.warn('AI response not valid JSON', { testId: testCase.id, parseError });
+            }
+        }
+    }
+    catch (error) {
+        log.error('AI body fix failed', {
+            testId: testCase.id,
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+    return null;
+}
+/**
+ * Applies repairs to test cases
+ *
+ * @param tests - Original test cases
+ * @param repairs - Repairs to apply
+ * @returns Updated test cases
+ */
+export function applyRepairs(tests, repairs) {
+    const repairMap = new Map(repairs.map(r => [r.testId, r]));
+    return tests.map(test => {
+        const repair = repairMap.get(test.id);
+        if (!repair) {
+            return test;
+        }
+        log.info('Applying repair', {
+            testId: test.id,
+            type: repair.type,
+            confidence: repair.confidence
+        });
+        // Apply fix based on type
+        if (repair.type === 'fix_schema_validation' && repair.fix.newBody) {
+            return {
+                ...test,
+                body: repair.fix.newBody
+            };
+        }
+        // For dependency repairs, we don't modify the test itself
+        // The dependencies will be handled separately
+        return test;
+    });
+}
+//# sourceMappingURL=test-auto-repairer.js.map

package/dist/repairers/test-auto-repairer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-auto-repairer.js","sourceRoot":"","sources":["../../src/repairers/test-auto-repairer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,GAAG,GAAG,YAAY,CAAC,oBAAoB,CAAC,CAAC;AAwC/C;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,aAA2B,EAC3B,QAAoB,EACpB,SAA2B;IAE3B,GAAG,CAAC,IAAI,CAAC,wCAAwC,EAAE;QACjD,WAAW,EAAE,aAAa,CAAC,MAAM;KAClC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QAChE,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,gBAAgB;IAChB,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACvD,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,+BAA+B,EAAE;QACxC,KAAK,EAAE,aAAa,CAAC,MAAM;QAC3B,UAAU,EAAE,OAAO,CAAC,MAAM;QAC1B,MAAM;KACP,CAAC,CAAC;IAEH,OAAO;QACL,OAAO;QACP,OAAO,EAAE;YACP,KAAK,EAAE,aAAa,CAAC,MAAM;YAC3B,UAAU,EAAE,OAAO,CAAC,MAAM;YAC1B,MAAM,EAAE,MAAoC;SAC7C;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,aAAa,CAC1B,MAAkB,EAClB,QAAoB,EACpB,SAA2B;IAE3B,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IAEjD,6CAA6C;IAC7C,IAAI,YAAY,KAAK,GAAG,IAAI,YAAY,KAAK,GAAG,EAAE,CAAC;QACjD,OAAO;YACL,MAAM,EAAE,QAAQ,CAAC,EAAE;YACnB,IAAI,EAAE,qBAAqB;YAC3B,WAAW,EAAE,yDAAyD;YACtE,UAAU,EAAE,MAAM;YAClB,GAAG,EAAE;gBACH,aAAa,EAAE,eAAe;gBAC9B,MAAM,EAAE,6CAA6C;aACtD;SACF,CAAC;IACJ,CAAC;IAED,+DAA+D;IAC/D,IAAI,YAAY,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QACvD,MAAM,UAAU,GAAG,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACtD,IAAI,UAAU,EAAE,CAAC;YACf,OAAO;gBACL,MAAM,EAAE,QAAQ,CAAC,EAAE;gBACnB,IAAI,EAAE,yBAAyB;gBAC/B,WAAW,EAAE,+CAA+C;gBAC5D,UAAU,EAAE,MAAM;gBAClB,GAAG,EAAE;oBACH,aAAa,EAAE,UAAU,CAAC,EAAE;oBAC5B,SAAS,EAAE,kBAAkB;oBAC7B,QAAQ,EAAE,QAAQ,QAAQ,CAAC,IAAI,EAAE;oBACjC,MAAM,EAAE,2CAA2C,UAAU,CAAC,IAAI,EAAE;iBACrE;aACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,IAAI,YAAY,KAAK,GAAG,EAAE,CAAC;QACzB,qBAAqB;QACrB,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAClC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,CACzD,CAAC;QAEF,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC9B,MAAM,SAAS,GAAG,MAAM,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;YACxE,IAAI,SAAS,EAAE,CAAC;gBACd,OAAO;oBACL,MAAM,EAAE,QAAQ,CAAC,EAAE;oBACnB,IAAI,EAAE,uBAAuB;oBAC7B,WAAW,EAAE,oCAAoC;oBACjD,UAAU,EAAE,QAAQ;oBACpB,GAAG,EAAE;wBACH,OAAO,EAAE,SAAS;wBAClB,MAAM,EAAE,2CAA2C;qBACpD;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,SAAS,cAAc,CAAC,QAAkB,EAAE,QAAoB;IAC9D,yCAAyC;IACzC,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IAE7D,kCAAkC;IAClC,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACtC,CAAC,CAAC,MAAM,KAAK,MAAM;QACnB,CAAC,CAAC,IAAI,KAAK,QAAQ;QACnB,CAAC,CAAC,QAAQ,KAAK,YAAY;QAC3B,CAAC,CAAC,cAAc,IAAI,GAAG;QACvB,CAAC,CAAC,cAAc,GAAG,GAAG,CACvB,CAAC;IAEF,OAAO,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACxD,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,oBAAoB,CACjC,QAAkB,EAClB,QAAwB,EACxB,KAAc;IAEd,IAAI,CAAC;QACH,MAAM,MAAM,GAAG;;YAEP,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI;gBAC5B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;mBACnC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;SACvD,KAAK,IAAI,0BAA0B;;uDAEW,CAAC;QAEpD,GAAG,CAAC,KAAK,CAAC,wBAAwB,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QAE7D,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE;YACnC,SAAS,EAAE,GAAG;YACd,WAAW,EAAE,GAAG;YAChB,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAClC,8CAA8C;YAC9C,IAAI,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACjC,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACzE,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACtC,GAAG,CAAC,IAAI,CAAC,oCAAoC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;gBACxE,OAAO,SAAS,CAAC;YACnB,CAAC;YAAC,OAAO,UAAU,EAAE,CAAC;gBACpB,GAAG,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,KAAK,CAAC,oBAAoB,EAAE;YAC9B,MAAM,EAAE,QAAQ,CAAC,EAAE;YACnB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAiB,EACjB,OAAqB;IAErB,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAE3D,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QACtB,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QAED,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE;YAC1B,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC,CAAC;QAEH,0BAA0B;QAC1B,IAAI,MAAM,CAAC,IAAI,KAAK,uBAAuB,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YAClE,OAAO;gBACL,GAAG,IAAI;gBACP,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO;aACzB,CAAC;QACJ,CAAC;QAED,0DAA0D;QAC1D,8CAA8C;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}