@machina.ai/openapi-contract-tester 2.1.0

package/dist/analyzers/ai-failure-analyzer.js

@@ -0,0 +1,220 @@
+/**
+ * AI-Powered Failure Analyzer
+ *
+ * Takes structured failure data and uses LLM to generate:
+ * - Human-readable summary
+ * - Actionable recommendations
+ * - Pattern detection
+ * - Critical issues identification
+ *
+ * @module analyzers/ai-failure-analyzer
+ */
+import { callLLM } from '../llm/ai-client.js';
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('ai-failure-analyzer');
+/**
+ * Analyzes failures using AI to generate actionable insights
+ *
+ * @param failureAnalysis - Structured failure analysis from heuristic analyzer
+ * @returns AI-generated insights and recommendations
+ */
+export async function analyzeFailuresWithAI(failureAnalysis) {
+    log.info('Starting AI failure analysis', {
+        totalFailures: failureAnalysis.summary.totalFailures
+    });
+    if (failureAnalysis.summary.totalFailures === 0) {
+        return {
+            summary: 'No hay fallos que analizar. Todos los tests pasaron exitosamente.',
+            recommendations: []
+        };
+    }
+    // Build compact prompt for AI
+    const prompt = buildAnalysisPrompt(failureAnalysis);
+    try {
+        const result = await callLLM(prompt, {
+            maxTokens: 4096,
+            temperature: 0.3
+        });
+        if (!result.success || !result.text) {
+            log.warn('AI analysis failed, returning basic summary');
+            return buildFallbackAnalysis(failureAnalysis);
+        }
+        // Parse AI response
+        const aiAnalysis = parseAIResponse(result.text, failureAnalysis);
+        log.info('AI analysis complete', {
+            recommendationsCount: aiAnalysis.recommendations.length,
+            patternsCount: aiAnalysis.patterns?.length || 0
+        });
+        return aiAnalysis;
+    }
+    catch (error) {
+        log.error('AI analysis failed', { error });
+        return buildFallbackAnalysis(failureAnalysis);
+    }
+}
+/**
+ * Builds the prompt for AI analysis
+ */
+function buildAnalysisPrompt(analysis) {
+    const failureSummary = {
+        total: analysis.summary.totalFailures,
+        byType: Object.entries(analysis.summary.byType)
+            .filter(([_, count]) => count > 0)
+            .map(([type, count]) => `${type}: ${count}`),
+        bySeverity: analysis.summary.bySeverity,
+        topFailures: analysis.failures.slice(0, 10).map(f => ({
+            test: f.testCase.name,
+            endpoint: `${f.request.method} ${f.request.url}`,
+            type: f.failureType,
+            expected: f.expected.status,
+            actual: f.actual.status,
+            error: f.validationErrors?.map(e => e.message).join('; ')
+        }))
+    };
+    return `Analiza estos fallos de tests de API y genera recomendaciones accionables.
+
+FALLOS:
+${JSON.stringify(failureSummary, null, 2)}
+
+Retorna SOLO JSON en este formato (sin texto adicional):
+{
+  "summary": "Resumen ejecutivo en 2-3 oraciones explicando los problemas principales",
+  "recommendations": [
+    {
+      "issue": "Descripción del problema",
+      "fix": "Solución específica y accionable",
+      "priority": "critical|high|medium|low",
+      "autoRepairSuggestion": "Comando o código para reparar automáticamente (opcional)"
+    }
+  ],
+  "patterns": [
+    {
+      "pattern": "Nombre del patrón detectado",
+      "occurrences": número,
+      "description": "Explicación del patrón",
+      "impact": "critical|high|medium|low"
+    }
+  ],
+  "criticalIssues": [
+    {
+      "title": "Título del issue crítico",
+      "description": "Descripción detallada",
+      "affectedEndpoints": ["GET /endpoint1", "POST /endpoint2"]
+    }
+  ]
+}
+
+IMPORTANTE:
+- El "summary" DEBE ser texto legible, NO un objeto JSON
+- Prioriza recomendaciones accionables sobre análisis genérico
+- Detecta patrones comunes (ej: todos los POST fallan con 401 → problema de auth)
+- Sugiere fixes específicos, no solo "revisar el código"`;
+}
+/**
+ * Parses AI response into structured analysis
+ */
+function parseAIResponse(text, fallback) {
+    try {
+        // Extract JSON from response (handle markdown code blocks)
+        const jsonMatch = text.match(/```(?:json)?\s*(\{[\s\S]*\})\s*```/) ||
+            text.match(/(\{[\s\S]*\})/);
+        if (!jsonMatch) {
+            log.warn('No JSON found in AI response, using fallback');
+            return buildFallbackAnalysis(fallback);
+        }
+        const parsed = JSON.parse(jsonMatch[1]);
+        // Validate summary is a string, not an object
+        if (typeof parsed.summary !== 'string') {
+            log.warn('AI returned object as summary, converting to string');
+            parsed.summary = `Se detectaron ${fallback.summary.totalFailures} fallos: ` +
+                `${fallback.summary.bySeverity.critical} críticos, ` +
+                `${fallback.summary.bySeverity.high} altos. ` +
+                `Los tipos más comunes son: ${Object.entries(fallback.summary.byType)
+                    .filter(([_, count]) => count > 0)
+                    .slice(0, 3)
+                    .map(([type, count]) => `${type} (${count})`)
+                    .join(', ')}.`;
+        }
+        return {
+            summary: parsed.summary || buildFallbackSummary(fallback),
+            recommendations: parsed.recommendations || [],
+            patterns: parsed.patterns || [],
+            errorExplanations: parsed.errorExplanations || {},
+            criticalIssues: parsed.criticalIssues || []
+        };
+    }
+    catch (error) {
+        log.error('Failed to parse AI response', { error });
+        return buildFallbackAnalysis(fallback);
+    }
+}
+/**
+ * Builds fallback analysis when AI is unavailable
+ */
+function buildFallbackAnalysis(analysis) {
+    return {
+        summary: buildFallbackSummary(analysis),
+        recommendations: buildFallbackRecommendations(analysis),
+        patterns: [],
+        errorExplanations: {}
+    };
+}
+/**
+ * Builds fallback summary from structured data
+ */
+function buildFallbackSummary(analysis) {
+    const { totalFailures, bySeverity, byType } = analysis.summary;
+    const topTypes = Object.entries(byType)
+        .filter(([_, count]) => count > 0)
+        .sort(([_, a], [__, b]) => b - a)
+        .slice(0, 3)
+        .map(([type, count]) => `${type} (${count})`)
+        .join(', ');
+    return `Se detectaron ${totalFailures} test${totalFailures !== 1 ? 's' : ''} fallido${totalFailures !== 1 ? 's' : ''}. ` +
+        `Severidad: ${bySeverity.critical} crítico${bySeverity.critical !== 1 ? 's' : ''}, ` +
+        `${bySeverity.high} alto${bySeverity.high !== 1 ? 's' : ''}, ` +
+        `${bySeverity.medium} medio${bySeverity.medium !== 1 ? 's' : ''}, ` +
+        `${bySeverity.low} bajo${bySeverity.low !== 1 ? 's' : ''}. ` +
+        `Tipos más comunes: ${topTypes}.`;
+}
+/**
+ * Builds fallback recommendations from structured data
+ */
+function buildFallbackRecommendations(analysis) {
+    const recommendations = [];
+    const { byType } = analysis.summary;
+    // Auth failures
+    if (byType.auth_failure > 0) {
+        recommendations.push({
+            issue: `${byType.auth_failure} test${byType.auth_failure !== 1 ? 's' : ''} fallaron por autenticación`,
+            fix: 'Verificar que los tokens de autenticación sean válidos y no hayan expirado',
+            priority: 'critical'
+        });
+    }
+    // Status mismatches
+    if (byType.status_mismatch > 0) {
+        recommendations.push({
+            issue: `${byType.status_mismatch} test${byType.status_mismatch !== 1 ? 's' : ''} recibieron status code incorrecto`,
+            fix: 'Revisar la lógica del endpoint y validar que los códigos de estado sean correctos según el caso',
+            priority: 'high'
+        });
+    }
+    // Connection errors
+    if (byType.connection_error > 0) {
+        recommendations.push({
+            issue: `${byType.connection_error} test${byType.connection_error !== 1 ? 's' : ''} no pudieron conectarse al servidor`,
+            fix: 'Verificar que el servidor esté corriendo y accesible en la URL configurada',
+            priority: 'critical'
+        });
+    }
+    // Schema validation
+    if (byType.schema_validation_failed > 0) {
+        recommendations.push({
+            issue: `${byType.schema_validation_failed} test${byType.schema_validation_failed !== 1 ? 's' : ''} fallaron en validación de schema`,
+            fix: 'Revisar que la respuesta del API cumpla con el schema definido en OpenAPI',
+            priority: 'medium'
+        });
+    }
+    return recommendations;
+}
+//# sourceMappingURL=ai-failure-analyzer.js.map

package/dist/analyzers/ai-failure-analyzer.js.map

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

package/dist/analyzers/comparison-utils.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Comparison Utilities
+ *
+ * Shared utility functions for source comparison logic.
+ *
+ * @module analyzers/comparison-utils
+ */
+/**
+ * Calculates priority level for a discrepancy based on endpoint importance.
+ *
+ * Uses keyword-based heuristics to determine business priority:
+ * - critical: auth, payment, login, checkout, order, transaction
+ * - high: user, account, profile, admin, subscription
+ * - medium: product, item, cart, search, notification
+ * - low: debug, test, health, metrics, deprecated
+ *
+ * @param endpoint - Endpoint path
+ * @param severity - Severity level
+ * @returns Priority level
+ */
+export declare function calculatePriority(endpoint: string | undefined, severity: 'error' | 'warning' | 'info'): 'critical' | 'high' | 'medium' | 'low';
+/**
+ * Creates a normalized key for endpoint comparison
+ *
+ * @param method - HTTP method
+ * @param path - Endpoint path
+ * @param normalizeParams - Whether to normalize path parameters
+ * @returns Normalized endpoint key
+ */
+export declare function createEndpointKey(method: string, path: string, normalizeParams: boolean): string;
+//# sourceMappingURL=comparison-utils.d.ts.map

package/dist/analyzers/comparison-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparison-utils.d.ts","sourceRoot":"","sources":["../../src/analyzers/comparison-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GACrC,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CA4CxC;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,GAAG,MAAM,CAWhG"}

package/dist/analyzers/comparison-utils.js

@@ -0,0 +1,85 @@
+/**
+ * Comparison Utilities
+ *
+ * Shared utility functions for source comparison logic.
+ *
+ * @module analyzers/comparison-utils
+ */
+/**
+ * Calculates priority level for a discrepancy based on endpoint importance.
+ *
+ * Uses keyword-based heuristics to determine business priority:
+ * - critical: auth, payment, login, checkout, order, transaction
+ * - high: user, account, profile, admin, subscription
+ * - medium: product, item, cart, search, notification
+ * - low: debug, test, health, metrics, deprecated
+ *
+ * @param endpoint - Endpoint path
+ * @param severity - Severity level
+ * @returns Priority level
+ */
+export function calculatePriority(endpoint, severity) {
+    if (!endpoint) {
+        if (severity === 'error')
+            return 'high';
+        if (severity === 'warning')
+            return 'medium';
+        return 'low';
+    }
+    const path = endpoint.toLowerCase();
+    const criticalKeywords = [
+        'auth', 'login', 'signin', 'signup', 'register',
+        'payment', 'checkout', 'purchase', 'buy',
+        'order', 'transaction', 'transfer',
+        'password', 'reset', 'verify', 'token'
+    ];
+    const highKeywords = [
+        'user', 'account', 'profile', 'settings',
+        'admin', 'role', 'permission',
+        'subscription', 'billing', 'invoice'
+    ];
+    const mediumKeywords = [
+        'product', 'item', 'catalog',
+        'cart', 'wishlist',
+        'search', 'filter', 'query',
+        'notification', 'message', 'email'
+    ];
+    const lowKeywords = [
+        'debug', 'test', 'mock',
+        'health', 'ping', 'status',
+        'metrics', 'analytics', 'log',
+        'deprecated', 'legacy', 'old'
+    ];
+    if (criticalKeywords.some(k => path.includes(k)))
+        return 'critical';
+    if (highKeywords.some(k => path.includes(k)))
+        return 'high';
+    if (mediumKeywords.some(k => path.includes(k)))
+        return 'medium';
+    if (lowKeywords.some(k => path.includes(k)))
+        return 'low';
+    if (severity === 'error')
+        return 'high';
+    if (severity === 'warning')
+        return 'medium';
+    return 'low';
+}
+/**
+ * Creates a normalized key for endpoint comparison
+ *
+ * @param method - HTTP method
+ * @param path - Endpoint path
+ * @param normalizeParams - Whether to normalize path parameters
+ * @returns Normalized endpoint key
+ */
+export function createEndpointKey(method, path, normalizeParams) {
+    let normalizedPath = path;
+    if (normalizeParams) {
+        // Normalize path parameters: /users/:id -> /users/{id}
+        normalizedPath = path.replace(/:(\w+)/g, '{$1}');
+        // Normalize trailing slashes
+        normalizedPath = normalizedPath.replace(/\/$/, '');
+    }
+    return `${method.toUpperCase()} ${normalizedPath}`;
+}
+//# sourceMappingURL=comparison-utils.js.map

package/dist/analyzers/comparison-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparison-utils.js","sourceRoot":"","sources":["../../src/analyzers/comparison-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAA4B,EAC5B,QAAsC;IAEtC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,IAAI,QAAQ,KAAK,OAAO;YAAE,OAAO,MAAM,CAAC;QACxC,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAEpC,MAAM,gBAAgB,GAAG;QACvB,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU;QAC/C,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK;QACxC,OAAO,EAAE,aAAa,EAAE,UAAU;QAClC,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO;KACvC,CAAC;IAEF,MAAM,YAAY,GAAG;QACnB,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU;QACxC,OAAO,EAAE,MAAM,EAAE,YAAY;QAC7B,cAAc,EAAE,SAAS,EAAE,SAAS;KACrC,CAAC;IAEF,MAAM,cAAc,GAAG;QACrB,SAAS,EAAE,MAAM,EAAE,SAAS;QAC5B,MAAM,EAAE,UAAU;QAClB,QAAQ,EAAE,QAAQ,EAAE,OAAO;QAC3B,cAAc,EAAE,SAAS,EAAE,OAAO;KACnC,CAAC;IAEF,MAAM,WAAW,GAAG;QAClB,OAAO,EAAE,MAAM,EAAE,MAAM;QACvB,QAAQ,EAAE,MAAM,EAAE,QAAQ;QAC1B,SAAS,EAAE,WAAW,EAAE,KAAK;QAC7B,YAAY,EAAE,QAAQ,EAAE,KAAK;KAC9B,CAAC;IAEF,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,UAAU,CAAC;IACpE,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IAC5D,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,QAAQ,CAAC;IAChE,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAE1D,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,MAAM,CAAC;IACxC,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC5C,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,IAAY,EAAE,eAAwB;IACtF,IAAI,cAAc,GAAG,IAAI,CAAC;IAE1B,IAAI,eAAe,EAAE,CAAC;QACpB,uDAAuD;QACvD,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACjD,6BAA6B;QAC7B,cAAc,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,GAAG,MAAM,CAAC,WAAW,EAAE,IAAI,cAAc,EAAE,CAAC;AACrD,CAAC"}

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

@@ -0,0 +1,49 @@
+/**
+ * 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 type { OpenAPIV3 } from 'openapi-types';
+import type { APIContext } from '../llm/data-generator-ai.js';
+export type { APIContext };
+/**
+ * Detects the type of API from the OpenAPI specification
+ *
+ * @param spec - OpenAPI specification document
+ * @returns API context with detected type and settings
+ */
+export declare function detectAPIContext(spec: OpenAPIV3.Document): Promise<APIContext>;
+/**
+ * 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 declare function enrichAPIContext(context: APIContext, endpoints: {
+    path: string;
+}[]): APIContext;
+/**
+ * Infers the purpose of a specific endpoint
+ *
+ * @param path - Endpoint path
+ * @param method - HTTP method
+ * @param operation - OpenAPI operation object
+ * @returns Inferred purpose
+ */
+export declare function inferEndpointPurpose(path: string, method: string, operation?: OpenAPIV3.OperationObject): string;
+//# sourceMappingURL=context-analyzer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context-analyzer.d.ts","sourceRoot":"","sources":["../../src/analyzers/context-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAG9D,YAAY,EAAE,UAAU,EAAE,CAAC;AAI3B;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAiDpF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,UAAU,EACnB,SAAS,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAC5B,UAAU,CAgCZ;AAwJD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,SAAS,CAAC,eAAe,GACpC,MAAM,CAsCR"}