@machina.ai/openapi-contract-tester 2.1.0

package/dist/analyzers/context-analyzer.js

@@ -0,0 +1,292 @@
+/**
+ * API Context Analyzer
+ *
+ * Analyzes OpenAPI specifications to determine the type of API
+ * (banking, ecommerce, blog, internal, etc.) for contextual test generation.
+ *
+ * @module analyzers/context-analyzer
+ */
+import { callLLM } from '../llm/ai-client.js';
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('context-analyzer');
+/**
+ * Detects the type of API from the OpenAPI specification
+ *
+ * @param spec - OpenAPI specification document
+ * @returns API context with detected type and settings
+ */
+export async function detectAPIContext(spec) {
+    // Check if AI context detection is disabled
+    const useAI = process.env.USE_AI_CONTEXT !== 'false';
+    if (!useAI) {
+        log.info('AI context detection disabled (USE_AI_CONTEXT=false), using heuristics');
+        return detectAPIContextHeuristic(spec);
+    }
+    try {
+        // Gather information from the spec
+        const title = spec.info.title || 'Unknown API';
+        const description = spec.info.description || '';
+        const endpoints = Object.keys(spec.paths).slice(0, 15); // Sample first 15 endpoints
+        const version = spec.info.version || '';
+        log.info('Analyzing API context with AI', {
+            title,
+            endpointCount: Object.keys(spec.paths).length
+        });
+        // Build prompt for LLM
+        const prompt = buildAPIContextPrompt(title, description, endpoints, version);
+        // Call LLM
+        const result = await callLLM(prompt, {
+            maxTokens: 128,
+            temperature: 0.1, // Low temperature for consistent classification
+            timeout: 10000 // 10 seconds is reasonable for this simple classification
+        });
+        if (!result.success || !result.text) {
+            log.warn('AI context detection failed, using heuristic fallback');
+            return detectAPIContextHeuristic(spec);
+        }
+        // Parse AI response
+        const detectedType = result.text.trim().toLowerCase();
+        const apiContext = buildAPIContext(detectedType);
+        log.info('API context detected with AI', apiContext);
+        return apiContext;
+    }
+    catch (error) {
+        log.error('Error detecting API context with AI, using heuristic fallback', {
+            error: error instanceof Error ? error.message : String(error)
+        });
+        return detectAPIContextHeuristic(spec);
+    }
+}
+/**
+ * Enriches APIContext with entity types inferred from endpoints
+ *
+ * Extracts entity names from endpoint paths (e.g., /api/users/{id} → 'users')
+ * to help the AI engine understand what domain entities the API deals with.
+ *
+ * @param context - Base API context to enrich
+ * @param endpoints - Array of parsed endpoints
+ * @returns Enriched API context with entityTypes populated
+ *
+ * @example
+ * ```typescript
+ * const baseContext = { type: 'banking', domain: 'banking', industry: 'financial', entityTypes: [] };
+ * const endpoints = [{ path: '/api/accounts/{id}' }, { path: '/api/transactions' }];
+ * const enriched = enrichAPIContext(baseContext, endpoints);
+ * // enriched.entityTypes = ['accounts', 'transactions']
+ * ```
+ */
+export function enrichAPIContext(context, endpoints) {
+    const entityTypes = new Set();
+    for (const endpoint of endpoints) {
+        // Extract path segments, filter out params and common prefixes
+        const pathParts = endpoint.path
+            .split('/')
+            .filter(p => p && !p.startsWith('{'))
+            .map(p => p.toLowerCase());
+        if (pathParts.length > 0) {
+            // Take the last significant segment (usually the entity name)
+            const entity = pathParts[pathParts.length - 1];
+            // Skip common API prefixes/versions
+            if (!['api', 'v1', 'v2', 'v3', 'v4', 'rest'].includes(entity)) {
+                entityTypes.add(entity);
+            }
+        }
+    }
+    const enrichedContext = {
+        ...context,
+        entityTypes: Array.from(entityTypes).slice(0, 10) // Limit to 10 most common
+    };
+    log.debug('Enriched API context', {
+        entityTypesFound: enrichedContext.entityTypes.length,
+        entities: enrichedContext.entityTypes
+    });
+    return enrichedContext;
+}
+/**
+ * Builds the prompt for API context detection
+ *
+ * @param title - API title
+ * @param description - API description
+ * @param endpoints - Sample of endpoint paths
+ * @param version - API version
+ * @returns Prompt string
+ */
+function buildAPIContextPrompt(title, description, endpoints, version) {
+    return `Analyze this API and classify it into ONE category.
+
+API Title: ${title}
+Version: ${version}
+Description: ${description}
+
+Sample Endpoints (${endpoints.length}):
+${endpoints.join('\n')}
+
+Classify as ONE of these types:
+- banking: Financial APIs with strict validation (IBANs, amounts, transactions, accounts, transfers)
+- ecommerce: Shopping APIs (products, cart, orders, checkout, payments, inventory)
+- blog: Content management APIs (posts, comments, articles, authors, categories)
+- healthcare: Medical/health APIs (patients, appointments, records, prescriptions)
+- education: Learning platforms (courses, students, assignments, grades)
+- social: Social networks (users, posts, likes, friends, messaging)
+- internal: Corporate/internal APIs (flexible, business-specific)
+- other: General purpose API
+
+Respond with ONLY the category name, nothing else.`;
+}
+/**
+ * Builds API context object from detected type
+ *
+ * @param type - Detected API type
+ * @returns API context object
+ */
+function buildAPIContext(type) {
+    // Validate type
+    const validTypes = [
+        'banking',
+        'ecommerce',
+        'blog',
+        'healthcare',
+        'education',
+        'social',
+        'internal',
+        'other'
+    ];
+    const normalizedType = validTypes.includes(type) ? type : 'other';
+    // Configure settings based on type
+    const strictTypes = ['banking', 'healthcare'];
+    const realFormatTypes = ['banking', 'ecommerce', 'healthcare'];
+    // Map type to industry
+    const industryMap = {
+        'banking': 'financial',
+        'ecommerce': 'retail',
+        'healthcare': 'medical',
+        'education': 'academic',
+        'social': 'social_network',
+        'blog': 'content_management',
+        'internal': 'enterprise',
+        'other': 'general'
+    };
+    return {
+        type: normalizedType,
+        validationLevel: strictTypes.includes(normalizedType) ? 'strict' : 'relaxed',
+        useRealFormats: realFormatTypes.includes(normalizedType),
+        domain: normalizedType,
+        industry: industryMap[normalizedType] || 'general',
+        entityTypes: [] // Will be populated by enrichAPIContext
+    };
+}
+/**
+ * Heuristic-based API context detection (fallback when AI fails)
+ *
+ * @param spec - OpenAPI specification
+ * @returns API context based on heuristics
+ */
+function detectAPIContextHeuristic(spec) {
+    const title = (spec.info.title || '').toLowerCase();
+    const description = (spec.info.description || '').toLowerCase();
+    const endpointPaths = Object.keys(spec.paths).map(p => p.toLowerCase()).join(' ');
+    const combined = `${title} ${description} ${endpointPaths}`;
+    // Banking keywords
+    if (hasKeywords(combined, ['bank', 'account', 'transfer', 'transaction', 'iban', 'payment', 'balance'])) {
+        log.info('Heuristic detected: banking');
+        return buildAPIContext('banking');
+    }
+    // E-commerce keywords
+    if (hasKeywords(combined, ['product', 'cart', 'order', 'checkout', 'shop', 'store', 'inventory'])) {
+        log.info('Heuristic detected: ecommerce');
+        return buildAPIContext('ecommerce');
+    }
+    // Blog/CMS keywords
+    if (hasKeywords(combined, ['post', 'article', 'comment', 'blog', 'author', 'category', 'tag'])) {
+        log.info('Heuristic detected: blog');
+        return buildAPIContext('blog');
+    }
+    // Healthcare keywords
+    if (hasKeywords(combined, ['patient', 'doctor', 'appointment', 'medical', 'health', 'prescription', 'diagnosis'])) {
+        log.info('Heuristic detected: healthcare');
+        return buildAPIContext('healthcare');
+    }
+    // Education keywords
+    if (hasKeywords(combined, ['course', 'student', 'teacher', 'assignment', 'grade', 'lesson', 'education'])) {
+        log.info('Heuristic detected: education');
+        return buildAPIContext('education');
+    }
+    // Social keywords
+    if (hasKeywords(combined, ['user', 'friend', 'follow', 'like', 'post', 'message', 'social', 'profile'])) {
+        log.info('Heuristic detected: social');
+        return buildAPIContext('social');
+    }
+    // Default to 'other'
+    log.info('Heuristic detected: other (default)');
+    return buildAPIContext('other');
+}
+/**
+ * Checks if text contains at least 2 keywords from the list
+ *
+ * @param text - Text to search
+ * @param keywords - List of keywords
+ * @returns true if at least 2 keywords found
+ */
+function hasKeywords(text, keywords) {
+    const count = keywords.filter(keyword => text.includes(keyword)).length;
+    return count >= 2;
+}
+/**
+ * Infers the purpose of a specific endpoint
+ *
+ * @param path - Endpoint path
+ * @param method - HTTP method
+ * @param operation - OpenAPI operation object
+ * @returns Inferred purpose
+ */
+export function inferEndpointPurpose(path, method, operation) {
+    const pathLower = path.toLowerCase();
+    const methodUpper = method.toUpperCase();
+    // Check operation summary/description for hints
+    const summary = (operation?.summary || '').toLowerCase();
+    const description = (operation?.description || '').toLowerCase();
+    const combined = `${pathLower} ${summary} ${description}`;
+    // Authentication
+    if (combined.includes('login') || combined.includes('signin'))
+        return 'login';
+    if (combined.includes('logout') || combined.includes('signout'))
+        return 'logout';
+    if (combined.includes('register') || combined.includes('signup'))
+        return 'register';
+    if (combined.includes('auth') || combined.includes('token'))
+        return 'authentication';
+    // Payment & Financial
+    if (combined.includes('payment') || combined.includes('pay'))
+        return 'payment';
+    if (combined.includes('transfer'))
+        return 'transfer';
+    if (combined.includes('transaction'))
+        return 'transaction';
+    if (combined.includes('balance'))
+        return 'balance_check';
+    if (combined.includes('wallet'))
+        return 'wallet_management';
+    if (combined.includes('invoice'))
+        return 'invoice';
+    // User management
+    if (combined.includes('user') || combined.includes('profile')) {
+        if (methodUpper === 'POST')
+            return 'create_user';
+        if (methodUpper === 'PUT' || methodUpper === 'PATCH')
+            return 'update_user';
+        if (methodUpper === 'DELETE')
+            return 'delete_user';
+        return 'get_user';
+    }
+    // Generic CRUD
+    if (methodUpper === 'POST')
+        return 'create';
+    if (methodUpper === 'PUT' || methodUpper === 'PATCH')
+        return 'update';
+    if (methodUpper === 'DELETE')
+        return 'delete';
+    if (methodUpper === 'GET')
+        return 'retrieve';
+    return 'general';
+}
+//# sourceMappingURL=context-analyzer.js.map

package/dist/analyzers/context-analyzer.js.map

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

package/dist/analyzers/dependency-analyzer.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Dependency Analyzer
+ *
+ * Automatically detects dependencies between test cases based on:
+ * - Path parameter injection (GET /users/{id} depends on POST /users)
+ * - Authentication requirements
+ * - Resource hierarchies
+ *
+ * @module analyzers/dependency-analyzer
+ */
+import type { TestCase, ParsedEndpoint } from '../types/index.js';
+/**
+ * Detected dependency information
+ */
+export interface DetectedDependency {
+    testId: string;
+    dependsOn: string[];
+    reason: string;
+    confidence: 'high' | 'medium' | 'low';
+}
+/**
+ * Detects dependencies between test cases automatically
+ *
+ * @param tests - Array of test cases
+ * @param endpoints - Array of parsed endpoints
+ * @returns Dependency map (testId => array of dependency test IDs)
+ */
+export declare function detectDependencies(tests: TestCase[], endpoints: ParsedEndpoint[]): Record<string, string[]>;
+/**
+ * Merges auto-detected dependencies with user-provided dependencies
+ *
+ * @param autoDeps - Auto-detected dependencies
+ * @param userDeps - User-provided dependencies
+ * @returns Merged dependencies (user deps take precedence)
+ */
+export declare function mergeDependencies(autoDeps: Record<string, string[]>, userDeps: Record<string, string[]>): Record<string, string[]>;
+/**
+ * Validates dependencies to avoid circular references
+ *
+ * @param dependencies - Dependency map
+ * @returns Array of circular dependency errors
+ */
+export declare function validateDependencies(dependencies: Record<string, string[]>): string[];
+//# sourceMappingURL=dependency-analyzer.d.ts.map

package/dist/analyzers/dependency-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-analyzer.d.ts","sourceRoot":"","sources":["../../src/analyzers/dependency-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAKlE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACvC;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,QAAQ,EAAE,EACjB,SAAS,EAAE,cAAc,EAAE,GAC1B,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAwC1B;AA+PD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACjC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAkB1B;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACrC,MAAM,EAAE,CAkCV"}

package/dist/analyzers/dependency-analyzer.js

@@ -0,0 +1,313 @@
+/**
+ * Dependency Analyzer
+ *
+ * Automatically detects dependencies between test cases based on:
+ * - Path parameter injection (GET /users/{id} depends on POST /users)
+ * - Authentication requirements
+ * - Resource hierarchies
+ *
+ * @module analyzers/dependency-analyzer
+ */
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('dependency-analyzer');
+/**
+ * Detects dependencies between test cases automatically
+ *
+ * @param tests - Array of test cases
+ * @param endpoints - Array of parsed endpoints
+ * @returns Dependency map (testId => array of dependency test IDs)
+ */
+export function detectDependencies(tests, endpoints) {
+    log.info('Analyzing test dependencies', { testCount: tests.length });
+    const dependencies = {};
+    const detectedDeps = [];
+    // Pattern 1: Path parameter dependencies
+    const pathDeps = detectPathParameterDependencies(tests);
+    detectedDeps.push(...pathDeps);
+    // Pattern 2: Authentication dependencies
+    const authDeps = detectAuthenticationDependencies(tests, endpoints);
+    detectedDeps.push(...authDeps);
+    // Pattern 3: Resource hierarchy dependencies
+    const hierarchyDeps = detectResourceHierarchyDependencies(tests);
+    detectedDeps.push(...hierarchyDeps);
+    // Convert to dependency map
+    for (const dep of detectedDeps) {
+        if (!dependencies[dep.testId]) {
+            dependencies[dep.testId] = [];
+        }
+        for (const depTestId of dep.dependsOn) {
+            if (!dependencies[dep.testId].includes(depTestId)) {
+                dependencies[dep.testId].push(depTestId);
+            }
+        }
+    }
+    log.info('Dependencies detected', {
+        totalDependencies: Object.keys(dependencies).length,
+        byPattern: {
+            pathParams: pathDeps.length,
+            auth: authDeps.length,
+            hierarchy: hierarchyDeps.length
+        }
+    });
+    return dependencies;
+}
+/**
+ * Detects dependencies based on path parameters
+ * Example: GET /users/{id} depends on POST /users
+ *
+ * @param tests - Array of test cases
+ * @returns Array of detected dependencies
+ */
+function detectPathParameterDependencies(tests) {
+    const dependencies = [];
+    for (const test of tests) {
+        // Skip if test doesn't have path parameters
+        if (!test.path.includes('{')) {
+            continue;
+        }
+        // Skip if test is a creation endpoint (POST)
+        if (test.method === 'POST') {
+            continue;
+        }
+        // Extract base path (without parameters)
+        const basePath = extractBasePath(test.path);
+        // Find corresponding creation test (POST to base path)
+        const createTests = tests.filter(t => t.method === 'POST' &&
+            t.path === basePath &&
+            t.id !== test.id &&
+            t.category === 'happy-path' // Only depend on successful creation
+        );
+        if (createTests.length > 0) {
+            dependencies.push({
+                testId: test.id,
+                dependsOn: createTests.map(t => t.id),
+                reason: `Requires resource to exist (path parameter dependency: ${test.path})`,
+                confidence: 'high'
+            });
+            log.debug('Path parameter dependency detected', {
+                test: test.id,
+                dependsOn: createTests.map(t => t.id),
+                path: test.path,
+                basePath
+            });
+        }
+    }
+    return dependencies;
+}
+/**
+ * Detects authentication dependencies
+ * Tests that require auth depend on login/auth tests
+ *
+ * @param tests - Array of test cases
+ * @param endpoints - Array of parsed endpoints
+ * @returns Array of detected dependencies
+ */
+function detectAuthenticationDependencies(tests, endpoints) {
+    const dependencies = [];
+    // Find authentication tests (login, signin, token, auth endpoints)
+    const authTests = tests.filter(t => isAuthenticationTest(t) && t.category === 'happy-path');
+    if (authTests.length === 0) {
+        log.debug('No authentication tests found');
+        return dependencies;
+    }
+    // Use the first auth test as the dependency
+    const primaryAuthTest = authTests[0];
+    for (const test of tests) {
+        // Skip if test IS the auth test
+        if (test.id === primaryAuthTest.id) {
+            continue;
+        }
+        // Skip if test explicitly requires NO auth
+        if (test.requiresAuth === false) {
+            continue;
+        }
+        // Skip if test expects auth failure (401, 403)
+        if (test.expectedStatus === 401 || test.expectedStatus === 403) {
+            continue;
+        }
+        // Skip if test is also an auth test
+        if (isAuthenticationTest(test)) {
+            continue;
+        }
+        // Find endpoint info
+        const endpoint = endpoints.find(e => e.path === test.path && e.method === test.method);
+        // Check if endpoint requires auth
+        const requiresAuth = test.requiresAuth ?? endpoint?.requiresAuth ?? true;
+        if (requiresAuth && test.expectedStatus >= 200 && test.expectedStatus < 300) {
+            dependencies.push({
+                testId: test.id,
+                dependsOn: [primaryAuthTest.id],
+                reason: 'Requires authentication token',
+                confidence: 'high'
+            });
+            log.debug('Authentication dependency detected', {
+                test: test.id,
+                dependsOn: primaryAuthTest.id,
+                path: test.path
+            });
+        }
+    }
+    return dependencies;
+}
+/**
+ * Detects resource hierarchy dependencies
+ * Example: POST /users/{userId}/orders depends on POST /users
+ *
+ * @param tests - Array of test cases
+ * @returns Array of detected dependencies
+ */
+function detectResourceHierarchyDependencies(tests) {
+    const dependencies = [];
+    for (const test of tests) {
+        // Check if path has nested resources (multiple parameters or deep nesting)
+        const paramCount = (test.path.match(/\{[^}]+\}/g) || []).length;
+        if (paramCount === 0) {
+            continue;
+        }
+        // Extract parent path
+        const parentPath = extractParentResourcePath(test.path);
+        if (!parentPath) {
+            continue;
+        }
+        // Find parent resource creation tests
+        const parentCreateTests = tests.filter(t => t.method === 'POST' &&
+            matchesPath(t.path, parentPath) &&
+            t.id !== test.id &&
+            t.category === 'happy-path');
+        if (parentCreateTests.length > 0) {
+            dependencies.push({
+                testId: test.id,
+                dependsOn: parentCreateTests.map(t => t.id),
+                reason: `Requires parent resource to exist (${parentPath})`,
+                confidence: 'medium'
+            });
+            log.debug('Resource hierarchy dependency detected', {
+                test: test.id,
+                dependsOn: parentCreateTests.map(t => t.id),
+                path: test.path,
+                parentPath
+            });
+        }
+    }
+    return dependencies;
+}
+/**
+ * Checks if a test is an authentication test
+ *
+ * @param test - Test case
+ * @returns true if test is auth-related
+ */
+function isAuthenticationTest(test) {
+    const pathLower = test.path.toLowerCase();
+    const nameLower = test.name.toLowerCase();
+    return (pathLower.includes('/login') ||
+        pathLower.includes('/signin') ||
+        pathLower.includes('/auth') ||
+        pathLower.includes('/token') ||
+        pathLower.includes('/oauth') ||
+        nameLower.includes('login') ||
+        nameLower.includes('auth'));
+}
+/**
+ * Extracts base path by removing path parameters
+ * Example: /users/{id}/orders => /users
+ *
+ * @param path - Path with parameters
+ * @returns Base path without parameters
+ */
+function extractBasePath(path) {
+    // Remove the last segment if it contains a parameter
+    const segments = path.split('/').filter(s => s.length > 0);
+    const baseSegments = segments.slice(0, segments.findIndex(s => s.includes('{')));
+    if (baseSegments.length === 0) {
+        return '/';
+    }
+    return '/' + baseSegments.join('/');
+}
+/**
+ * Extracts parent resource path from nested path
+ * Example: /users/{userId}/orders/{orderId} => /users
+ *
+ * @param path - Nested path
+ * @returns Parent resource path or null
+ */
+function extractParentResourcePath(path) {
+    const segments = path.split('/').filter(s => s.length > 0);
+    // Find the first parameter
+    const firstParamIndex = segments.findIndex(s => s.includes('{'));
+    if (firstParamIndex === -1 || firstParamIndex === 0) {
+        return null;
+    }
+    // Return path up to first parameter
+    return '/' + segments.slice(0, firstParamIndex).join('/');
+}
+/**
+ * Checks if two paths match (ignoring parameters)
+ *
+ * @param path1 - First path
+ * @param path2 - Second path
+ * @returns true if paths match
+ */
+function matchesPath(path1, path2) {
+    // Normalize paths
+    const normalize = (p) => p.split('/').filter(s => s.length > 0).join('/');
+    return normalize(path1) === normalize(path2);
+}
+/**
+ * Merges auto-detected dependencies with user-provided dependencies
+ *
+ * @param autoDeps - Auto-detected dependencies
+ * @param userDeps - User-provided dependencies
+ * @returns Merged dependencies (user deps take precedence)
+ */
+export function mergeDependencies(autoDeps, userDeps) {
+    const merged = { ...autoDeps };
+    // Add or override with user dependencies
+    for (const [testId, deps] of Object.entries(userDeps)) {
+        if (!merged[testId]) {
+            merged[testId] = [];
+        }
+        // Add user deps, avoiding duplicates
+        for (const dep of deps) {
+            if (!merged[testId].includes(dep)) {
+                merged[testId].push(dep);
+            }
+        }
+    }
+    return merged;
+}
+/**
+ * Validates dependencies to avoid circular references
+ *
+ * @param dependencies - Dependency map
+ * @returns Array of circular dependency errors
+ */
+export function validateDependencies(dependencies) {
+    const errors = [];
+    const visited = new Set();
+    const recursionStack = new Set();
+    function detectCycle(testId, path = []) {
+        if (recursionStack.has(testId)) {
+            errors.push(`Circular dependency detected: ${path.join(' -> ')} -> ${testId}`);
+            return true;
+        }
+        if (visited.has(testId)) {
+            return false;
+        }
+        visited.add(testId);
+        recursionStack.add(testId);
+        const deps = dependencies[testId] || [];
+        for (const dep of deps) {
+            if (detectCycle(dep, [...path, testId])) {
+                return true;
+            }
+        }
+        recursionStack.delete(testId);
+        return false;
+    }
+    for (const testId of Object.keys(dependencies)) {
+        detectCycle(testId);
+    }
+    return errors;
+}
+//# sourceMappingURL=dependency-analyzer.js.map