@machina.ai/openapi-contract-tester 2.1.0

package/dist/mcp/services/report-service.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Report Service - Test result reporting and formatting
+ *
+ * Centralizes all test result reporting including:
+ * - Markdown generation
+ * - HTML generation
+ * - JSON formatting
+ * - Summary statistics
+ *
+ * @module mcp/services/report-service
+ */
+import type { TestResult } from '../../types/index.js';
+/**
+ * Options for HTML report generation
+ */
+export interface HtmlReportOptions {
+    apiName?: string;
+    title?: string;
+    includeFullDetails?: boolean;
+    includeCharts?: boolean;
+    theme?: 'light' | 'dark';
+    aiAnalysis?: any;
+    coverage?: any;
+    sourceComparison?: any;
+    failureDiscrepancyCorrelation?: any;
+}
+/**
+ * Service for test result reporting
+ */
+export declare class ReportService {
+    /**
+     * Generates a Markdown report from test results
+     *
+     * @param results - Test results to report
+     * @returns Markdown formatted report
+     */
+    generateMarkdown(results: TestResult[]): string;
+    /**
+     * Generates an HTML report from test results
+     *
+     * @param results - Test results to report
+     * @param options - HTML generation options
+     * @returns HTML formatted report
+     */
+    generateHTML(results: TestResult[], options?: HtmlReportOptions): string;
+    /**
+     * Generates a JSON report from test results
+     *
+     * @param results - Test results to report
+     * @returns JSON formatted report
+     */
+    generateJSON(results: TestResult[]): string;
+    /**
+     * Calculates summary statistics from test results
+     *
+     * @param results - Test results to summarize
+     * @returns Summary object
+     */
+    calculateSummary(results: TestResult[]): {
+        total: number;
+        passed: number;
+        failed: number;
+        skipped: number;
+        passRate: string;
+        duration: number;
+        avgResponseTime: number;
+        byCategory: Record<string, {
+            passed: number;
+            failed: number;
+            total: number;
+        }>;
+    };
+    /**
+     * Groups test results by category
+     *
+     * @param results - Test results to group
+     * @returns Results grouped by category
+     */
+    private groupByCategory;
+}
+//# sourceMappingURL=report-service.d.ts.map

package/dist/mcp/services/report-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-service.d.ts","sourceRoot":"","sources":["../../../src/mcp/services/report-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAMvD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,gBAAgB,CAAC,EAAE,GAAG,CAAC;IACvB,6BAA6B,CAAC,EAAE,GAAG,CAAC;CACrC;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB;;;;;OAKG;IACH,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM;IAgD/C;;;;;;OAMG;IACH,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM;IAuDxE;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM;IA2B3C;;;;;OAKG;IACH,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG;QACvC,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,EAAE,MAAM,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC/E;IAwCD;;;;;OAKG;IACH,OAAO,CAAC,eAAe;CAaxB"}

package/dist/mcp/services/report-service.js

@@ -0,0 +1,210 @@
+/**
+ * Report Service - Test result reporting and formatting
+ *
+ * Centralizes all test result reporting including:
+ * - Markdown generation
+ * - HTML generation
+ * - JSON formatting
+ * - Summary statistics
+ *
+ * @module mcp/services/report-service
+ */
+import { generateProfessionalHtmlReport } from '../../reporters/html-report-generator.js';
+import { createLogger } from '../../utils/logger.js';
+const log = createLogger('report-service');
+/**
+ * Service for test result reporting
+ */
+export class ReportService {
+    /**
+     * Generates a Markdown report from test results
+     *
+     * @param results - Test results to report
+     * @returns Markdown formatted report
+     */
+    generateMarkdown(results) {
+        log.info('Generating Markdown report', { testCount: results.length });
+        const passed = results.filter(r => r.status === 'passed').length;
+        const failed = results.filter(r => r.status === 'failed').length;
+        const total = results.length;
+        const passRate = total > 0 ? ((passed / total) * 100).toFixed(1) : '0.0';
+        const lines = [];
+        // Header
+        lines.push('# Test Results\n');
+        lines.push(`**Total:** ${total} | **Passed:** ${passed} | **Failed:** ${failed} | **Pass Rate:** ${passRate}%\n`);
+        // Results by category
+        const byCategory = this.groupByCategory(results);
+        if (Object.keys(byCategory).length > 0) {
+            lines.push('## Results by Category\n');
+            for (const [category, categoryResults] of Object.entries(byCategory)) {
+                const catPassed = categoryResults.filter(r => r.status === 'passed').length;
+                const catTotal = categoryResults.length;
+                lines.push(`- **${category}**: ${catPassed}/${catTotal} passed\n`);
+            }
+            lines.push('');
+        }
+        // Failed tests detail
+        const failedTests = results.filter(r => r.status === 'failed');
+        if (failedTests.length > 0) {
+            lines.push('## Failed Tests\n');
+            for (const result of failedTests) {
+                lines.push(`### ${result.testCase.name}\n`);
+                lines.push(`- **Endpoint:** \`${result.testCase.method} ${result.testCase.path}\`\n`);
+                lines.push(`- **Expected Status:** ${result.testCase.expectedStatus}\n`);
+                lines.push(`- **Actual Status:** ${result.actualStatus || 'N/A'}\n`);
+                if (result.error) {
+                    lines.push(`- **Error:** ${result.error}\n`);
+                }
+                lines.push('');
+            }
+        }
+        const markdown = lines.join('');
+        log.info('Markdown report generated', { length: markdown.length });
+        return markdown;
+    }
+    /**
+     * Generates an HTML report from test results
+     *
+     * @param results - Test results to report
+     * @param options - HTML generation options
+     * @returns HTML formatted report
+     */
+    generateHTML(results, options) {
+        log.info('Generating HTML report', {
+            testCount: results.length,
+            options
+        });
+        try {
+            const summary = this.calculateSummary(results);
+            const byCategory = this.groupByCategory(results);
+            const byCategoryStats = Object.entries(byCategory).reduce((acc, [cat, catResults]) => {
+                acc[cat] = {
+                    passed: catResults.filter(r => r.status === 'passed').length,
+                    failed: catResults.filter(r => r.status === 'failed').length,
+                    total: catResults.length
+                };
+                return acc;
+            }, {});
+            // Build ReportData object
+            const reportData = {
+                ...(options?.apiName && { apiName: options.apiName }),
+                summary,
+                allTests: results.map(r => ({
+                    id: r.testCase.id,
+                    name: r.testCase.name,
+                    category: r.testCase.category,
+                    status: r.status,
+                    method: r.testCase.method,
+                    path: r.testCase.path,
+                    endpoint: `${r.testCase.method} ${r.testCase.path}`,
+                    expectedStatus: r.testCase.expectedStatus,
+                    actualStatus: r.actualStatus,
+                    error: r.error,
+                    duration: r.responseTime
+                })),
+                byCategory: byCategoryStats,
+                byEndpoint: {},
+                environment: 'Test',
+                timestamp: new Date().toISOString(),
+                ...(options?.aiAnalysis && { aiAnalysis: options.aiAnalysis }),
+                ...(options?.coverage && { coverage: options.coverage }),
+                ...(options?.sourceComparison && { sourceComparison: options.sourceComparison }),
+                ...(options?.failureDiscrepancyCorrelation && { failureDiscrepancyCorrelation: options.failureDiscrepancyCorrelation })
+            };
+            const html = generateProfessionalHtmlReport(reportData);
+            log.info('HTML report generated', { length: html.length });
+            return html;
+        }
+        catch (error) {
+            log.error('HTML report generation failed', { error });
+            throw new Error(`HTML report generation failed: ${error}`);
+        }
+    }
+    /**
+     * Generates a JSON report from test results
+     *
+     * @param results - Test results to report
+     * @returns JSON formatted report
+     */
+    generateJSON(results) {
+        log.info('Generating JSON report', { testCount: results.length });
+        const summary = this.calculateSummary(results);
+        const report = {
+            summary,
+            results: results.map(r => ({
+                id: r.testCase.id,
+                name: r.testCase.name,
+                status: r.status,
+                method: r.testCase.method,
+                path: r.testCase.path,
+                expectedStatus: r.testCase.expectedStatus,
+                actualStatus: r.actualStatus,
+                responseTime: r.responseTime,
+                error: r.error,
+                category: r.testCase.category
+            }))
+        };
+        const json = JSON.stringify(report, null, 2);
+        log.info('JSON report generated', { length: json.length });
+        return json;
+    }
+    /**
+     * Calculates summary statistics from test results
+     *
+     * @param results - Test results to summarize
+     * @returns Summary object
+     */
+    calculateSummary(results) {
+        const total = results.length;
+        const passed = results.filter(r => r.status === 'passed').length;
+        const failed = results.filter(r => r.status === 'failed').length;
+        const skipped = results.filter(r => r.status === 'skipped').length;
+        const passRate = total > 0 ? ((passed / total) * 100).toFixed(1) : '0.0';
+        const responseTimes = results
+            .filter(r => r.responseTime !== undefined)
+            .map(r => r.responseTime);
+        const totalDuration = responseTimes.length > 0
+            ? responseTimes.reduce((a, b) => a + b, 0)
+            : 0;
+        const avgResponseTime = responseTimes.length > 0
+            ? totalDuration / responseTimes.length
+            : 0;
+        const byCategory = this.groupByCategory(results);
+        const byCategorySummary = {};
+        for (const [category, categoryResults] of Object.entries(byCategory)) {
+            byCategorySummary[category] = {
+                passed: categoryResults.filter(r => r.status === 'passed').length,
+                failed: categoryResults.filter(r => r.status === 'failed').length,
+                total: categoryResults.length
+            };
+        }
+        return {
+            total,
+            passed,
+            failed,
+            skipped,
+            passRate,
+            duration: totalDuration,
+            avgResponseTime,
+            byCategory: byCategorySummary
+        };
+    }
+    /**
+     * Groups test results by category
+     *
+     * @param results - Test results to group
+     * @returns Results grouped by category
+     */
+    groupByCategory(results) {
+        const grouped = {};
+        for (const result of results) {
+            const category = result.testCase.category;
+            if (!grouped[category]) {
+                grouped[category] = [];
+            }
+            grouped[category].push(result);
+        }
+        return grouped;
+    }
+}
+//# sourceMappingURL=report-service.js.map

package/dist/mcp/services/report-service.js.map

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

package/dist/mcp/services/spec-service.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Spec Service - OpenAPI specification operations
+ *
+ * Centralizes all OpenAPI spec parsing, endpoint extraction,
+ * and authentication inference logic.
+ *
+ * @module mcp/services/spec-service
+ */
+import type { OpenAPIV3 } from 'openapi-types';
+import type { ParsedEndpoint, AuthConfig } from '../../types/index.js';
+/**
+ * Service for OpenAPI specification operations
+ */
+export declare class SpecService {
+    /**
+     * Parses an OpenAPI specification from a file
+     *
+     * @param specPath - Path to OpenAPI spec file (YAML or JSON)
+     * @returns Parsed OpenAPI document
+     */
+    parseSpec(specPath: string): Promise<OpenAPIV3.Document>;
+    /**
+     * Extracts endpoints from an OpenAPI document
+     *
+     * @param spec - OpenAPI document
+     * @returns Array of parsed endpoints with metadata
+     */
+    extractEndpoints(spec: OpenAPIV3.Document): Promise<ParsedEndpoint[]>;
+    /**
+     * Infers authentication configuration from OpenAPI spec
+     *
+     * @param spec - OpenAPI document
+     * @returns Inferred auth configuration
+     */
+    inferAuth(spec: OpenAPIV3.Document): Promise<AuthConfig>;
+    /**
+     * Discovers OpenAPI spec from a base URL
+     *
+     * Attempts to find the spec at common paths like:
+     * - /openapi.json
+     * - /swagger.json
+     * - /api-docs
+     * - etc.
+     *
+     * @param baseUrl - Base URL of the API
+     * @returns Path to discovered spec (temp file) or null if not found
+     */
+    discoverSpec(baseUrl: string): Promise<string | null>;
+    /**
+     * Parses spec from path or discovers from base URL
+     *
+     * @param specPath - Optional path to spec file
+     * @param baseUrl - Optional base URL for discovery
+     * @returns Parsed OpenAPI document
+     */
+    parseOrDiscoverSpec(specPath?: string, baseUrl?: string): Promise<OpenAPIV3.Document>;
+}
+//# sourceMappingURL=spec-service.d.ts.map

package/dist/mcp/services/spec-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-service.d.ts","sourceRoot":"","sources":["../../../src/mcp/services/spec-service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAKvE;;GAEG;AACH,qBAAa,WAAW;IACtB;;;;;OAKG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC;IAkB9D;;;;;OAKG;IACG,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,QAAQ,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAmB3E;;;;;OAKG;IACG,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAmB9D;;;;;;;;;;;OAWG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAmB3D;;;;;;OAMG;IACG,mBAAmB,CACvB,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC;CAmB/B"}

package/dist/mcp/services/spec-service.js

@@ -0,0 +1,140 @@
+/**
+ * Spec Service - OpenAPI specification operations
+ *
+ * Centralizes all OpenAPI spec parsing, endpoint extraction,
+ * and authentication inference logic.
+ *
+ * @module mcp/services/spec-service
+ */
+import { parseOpenAPISpec, extractEndpoints, inferAuthFromSpec } from '../../parsers/openapi-parser.js';
+import { discoverOpenAPI } from '../../utils/openapi-discovery.js';
+import { createLogger } from '../../utils/logger.js';
+const log = createLogger('spec-service');
+/**
+ * Service for OpenAPI specification operations
+ */
+export class SpecService {
+    /**
+     * Parses an OpenAPI specification from a file
+     *
+     * @param specPath - Path to OpenAPI spec file (YAML or JSON)
+     * @returns Parsed OpenAPI document
+     */
+    async parseSpec(specPath) {
+        log.info('Parsing OpenAPI spec', { path: specPath });
+        try {
+            const spec = await parseOpenAPISpec(specPath);
+            log.info('OpenAPI spec parsed successfully', {
+                path: specPath,
+                title: spec.info?.title,
+                version: spec.info?.version,
+                paths: Object.keys(spec.paths || {}).length
+            });
+            return spec;
+        }
+        catch (error) {
+            log.error('Failed to parse OpenAPI spec', { path: specPath, error });
+            throw new Error(`Failed to parse OpenAPI spec from ${specPath}: ${error}`);
+        }
+    }
+    /**
+     * Extracts endpoints from an OpenAPI document
+     *
+     * @param spec - OpenAPI document
+     * @returns Array of parsed endpoints with metadata
+     */
+    async extractEndpoints(spec) {
+        log.info('Extracting endpoints from spec', {
+            title: spec.info?.title,
+            pathCount: Object.keys(spec.paths || {}).length
+        });
+        try {
+            const endpoints = extractEndpoints(spec);
+            log.info('Endpoints extracted successfully', {
+                count: endpoints.length,
+                methods: [...new Set(endpoints.map(e => e.method))]
+            });
+            return endpoints;
+        }
+        catch (error) {
+            log.error('Failed to extract endpoints', { error });
+            throw new Error(`Failed to extract endpoints: ${error}`);
+        }
+    }
+    /**
+     * Infers authentication configuration from OpenAPI spec
+     *
+     * @param spec - OpenAPI document
+     * @returns Inferred auth configuration
+     */
+    async inferAuth(spec) {
+        log.info('Inferring authentication from spec', {
+            title: spec.info?.title
+        });
+        try {
+            const auth = inferAuthFromSpec(spec);
+            log.info('Authentication inferred', {
+                type: auth.type,
+                hasToken: !!auth.token,
+                hasOAuth2: !!auth.oauth2
+            });
+            return auth;
+        }
+        catch (error) {
+            log.error('Failed to infer auth', { error });
+            throw new Error(`Failed to infer authentication: ${error}`);
+        }
+    }
+    /**
+     * Discovers OpenAPI spec from a base URL
+     *
+     * Attempts to find the spec at common paths like:
+     * - /openapi.json
+     * - /swagger.json
+     * - /api-docs
+     * - etc.
+     *
+     * @param baseUrl - Base URL of the API
+     * @returns Path to discovered spec (temp file) or null if not found
+     */
+    async discoverSpec(baseUrl) {
+        log.info('Discovering OpenAPI spec', { baseUrl });
+        try {
+            const specPath = await discoverOpenAPI(baseUrl);
+            if (specPath) {
+                log.info('OpenAPI spec discovered', { baseUrl, path: specPath });
+            }
+            else {
+                log.warn('OpenAPI spec not found', { baseUrl });
+            }
+            return specPath;
+        }
+        catch (error) {
+            log.error('Failed to discover OpenAPI spec', { baseUrl, error });
+            return null;
+        }
+    }
+    /**
+     * Parses spec from path or discovers from base URL
+     *
+     * @param specPath - Optional path to spec file
+     * @param baseUrl - Optional base URL for discovery
+     * @returns Parsed OpenAPI document
+     */
+    async parseOrDiscoverSpec(specPath, baseUrl) {
+        // If spec path provided, use it
+        if (specPath) {
+            return this.parseSpec(specPath);
+        }
+        // Otherwise, try to discover from base URL
+        if (baseUrl) {
+            const discoveredPath = await this.discoverSpec(baseUrl);
+            if (discoveredPath) {
+                return this.parseSpec(discoveredPath);
+            }
+            throw new Error(`OpenAPI spec not found at ${baseUrl}. Please provide specPath explicitly.`);
+        }
+        throw new Error('Either specPath or baseUrl must be provided');
+    }
+}
+//# sourceMappingURL=spec-service.js.map

package/dist/mcp/services/spec-service.js.map

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

package/dist/parsers/endpoint-extractor.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Endpoint Extractor
+ *
+ * Extracts and resolves endpoint information from OpenAPI specifications.
+ *
+ * @module parsers/endpoint-extractor
+ */
+import type { OpenAPIV3 } from 'openapi-types';
+import type { ParsedEndpoint } from '../types/index.js';
+/**
+ * Extracts all endpoints from an OpenAPI specification
+ *
+ * @param spec - Parsed OpenAPI specification
+ * @returns Array of parsed endpoints with their metadata
+ */
+export declare function extractEndpoints(spec: OpenAPIV3.Document): ParsedEndpoint[];
+/**
+ * Extracts security schemes from an OpenAPI specification
+ *
+ * @param spec - Parsed OpenAPI specification
+ * @returns Map of security scheme name to security scheme object
+ */
+export declare function extractSecuritySchemes(spec: OpenAPIV3.Document): Record<string, OpenAPIV3.SecuritySchemeObject>;
+/**
+ * Resolves security requirements to actual security scheme objects
+ *
+ * @param security - Security requirements array from operation or global
+ * @param schemes - Available security schemes from spec
+ * @returns Array of resolved security scheme objects
+ */
+export declare function resolveSecurityRequirements(security: OpenAPIV3.SecurityRequirementObject[] | undefined, schemes: Record<string, OpenAPIV3.SecuritySchemeObject>): OpenAPIV3.SecuritySchemeObject[];
+//# sourceMappingURL=endpoint-extractor.d.ts.map

package/dist/parsers/endpoint-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-extractor.d.ts","sourceRoot":"","sources":["../../src/parsers/endpoint-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAc,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMpE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,QAAQ,GAAG,cAAc,EAAE,CAyI3E;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,SAAS,CAAC,QAAQ,GACvB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,oBAAoB,CAAC,CAEhD;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,SAAS,CAAC,yBAAyB,EAAE,GAAG,SAAS,EAC3D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,oBAAoB,CAAC,GACtD,SAAS,CAAC,oBAAoB,EAAE,CAmBlC"}