@machina.ai/openapi-contract-tester 2.1.0

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

@@ -0,0 +1,189 @@
+/**
+ * LLM Service - AI/LLM operations
+ *
+ * Centralizes all LLM interactions including:
+ * - Calling AI for test generation
+ * - TOON format conversion
+ * - Prompt construction
+ *
+ * @module mcp/services/llm-service
+ */
+import { callLLM, toTOONFormat } from '../../llm/ai-client.js';
+import { encode as toTOON, decode as fromTOON } from '@toon-format/toon';
+import { createLogger } from '../../utils/logger.js';
+const log = createLogger('llm-service');
+/**
+ * Service for LLM operations
+ */
+export class LLMService {
+    /**
+     * Calls the LLM with a prompt
+     *
+     * @param prompt - Prompt text to send to LLM
+     * @param options - Optional configuration
+     * @returns LLM response text
+     */
+    async callLLM(prompt, options) {
+        log.info('Calling LLM', {
+            promptLength: prompt.length,
+            model: options?.model
+        });
+        try {
+            const result = await callLLM(prompt, {
+                temperature: options?.temperature
+            });
+            if (!result.success || !result.text) {
+                throw new Error(result.error || 'LLM call failed with no response');
+            }
+            log.info('LLM response received', {
+                responseLength: result.text.length
+            });
+            return result.text;
+        }
+        catch (error) {
+            log.error('LLM call failed', { error });
+            throw new Error(`LLM call failed: ${error}`);
+        }
+    }
+    /**
+     * Formats data as TOON (Tree Object Oriented Notation)
+     *
+     * @param data - Data to format
+     * @returns TOON formatted string
+     */
+    formatAsTOON(data) {
+        log.debug('Formatting data as TOON');
+        try {
+            const toon = toTOON(data);
+            log.debug('TOON formatting complete', {
+                outputLength: toon.length
+            });
+            return toon;
+        }
+        catch (error) {
+            log.error('TOON formatting failed', { error });
+            throw new Error(`TOON formatting failed: ${error}`);
+        }
+    }
+    /**
+     * Parses TOON formatted text back to data
+     *
+     * @param text - TOON formatted text
+     * @returns Parsed data
+     */
+    parseTOONResponse(text) {
+        log.debug('Parsing TOON response', {
+            textLength: text.length
+        });
+        try {
+            const data = fromTOON(text);
+            log.debug('TOON parsing complete');
+            return data;
+        }
+        catch (error) {
+            log.error('TOON parsing failed', { error });
+            throw new Error(`TOON parsing failed: ${error}`);
+        }
+    }
+    /**
+     * Converts data to TOON format for AI consumption
+     *
+     * Uses toTOONFormat from ai-client which handles special formatting
+     * for AI prompts.
+     *
+     * @param data - Data to convert
+     * @returns TOON formatted string for AI
+     */
+    toTOONFormatForAI(data) {
+        log.debug('Converting to TOON format for AI');
+        try {
+            const toon = toTOONFormat(data);
+            log.debug('TOON conversion complete', {
+                outputLength: toon.length
+            });
+            return toon;
+        }
+        catch (error) {
+            log.error('TOON conversion failed', { error });
+            throw new Error(`TOON conversion for AI failed: ${error}`);
+        }
+    }
+    /**
+     * Constructs a prompt for test generation
+     *
+     * @param params - Parameters for prompt construction
+     * @returns Constructed prompt
+     */
+    constructTestGenerationPrompt(params) {
+        const { endpoints, userStories, apiContext, categories } = params;
+        log.info('Constructing test generation prompt', {
+            endpointCount: endpoints.length,
+            hasUserStories: !!userStories,
+            hasApiContext: !!apiContext,
+            categories: categories?.length || 0
+        });
+        const parts = [];
+        // Header
+        parts.push('Generate comprehensive test cases for the following API endpoints.\n');
+        // Endpoints in TOON format
+        parts.push('# Endpoints\n');
+        parts.push(this.formatAsTOON(endpoints));
+        parts.push('\n');
+        // User stories if provided
+        if (userStories) {
+            parts.push('# User Stories\n');
+            parts.push(userStories);
+            parts.push('\n');
+        }
+        // API context if provided
+        if (apiContext) {
+            parts.push('# API Context\n');
+            parts.push(this.formatAsTOON(apiContext));
+            parts.push('\n');
+        }
+        // Categories to generate
+        if (categories && categories.length > 0) {
+            parts.push('# Categories to Generate\n');
+            parts.push(categories.join(', '));
+            parts.push('\n');
+        }
+        // Instructions
+        parts.push('# Instructions\n');
+        parts.push('Generate test cases in the following categories:\n');
+        parts.push('- happy-path: Valid scenarios that should succeed\n');
+        parts.push('- edge-case: Boundary values and special cases\n');
+        parts.push('- error-case: Invalid inputs that should fail\n');
+        if (userStories) {
+            parts.push('- business-rule: Tests based on user stories\n');
+        }
+        parts.push('\n');
+        parts.push('Return test cases as JSON array.');
+        const prompt = parts.join('');
+        log.debug('Prompt constructed', { length: prompt.length });
+        return prompt;
+    }
+    /**
+     * Constructs a prompt for failure analysis
+     *
+     * @param failedTests - Failed test results
+     * @returns Constructed prompt
+     */
+    constructFailureAnalysisPrompt(failedTests) {
+        log.info('Constructing failure analysis prompt', {
+            failedTestCount: failedTests.length
+        });
+        const parts = [];
+        parts.push('Analyze the following failed test cases and provide insights.\n\n');
+        parts.push('# Failed Tests\n');
+        parts.push(this.formatAsTOON(failedTests));
+        parts.push('\n\n');
+        parts.push('Provide:\n');
+        parts.push('1. Root cause analysis\n');
+        parts.push('2. Common patterns in failures\n');
+        parts.push('3. Suggested fixes\n');
+        const prompt = parts.join('');
+        log.debug('Failure analysis prompt constructed', { length: prompt.length });
+        return prompt;
+    }
+}
+//# sourceMappingURL=llm-service.js.map

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

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

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

@@ -0,0 +1,128 @@
+/**
+ * Postman Service - Converts test cases to Postman Collections
+ *
+ * Generates Postman Collection v2.1 JSON format manually
+ * compatible with Postman app and Newman CLI.
+ *
+ * @module mcp/services/postman-service
+ */
+import type { TestCase } from '../../types/index.js';
+/**
+ * Options for Postman collection generation
+ */
+export interface PostmanCollectionOptions {
+    /** Collection name */
+    name: string;
+    /** Base URL for all requests */
+    baseUrl?: string;
+    /** Include test scripts (pm.test assertions) */
+    includeTests?: boolean;
+    /** Group requests by category into folders */
+    groupByCategory?: boolean;
+    /** Collection-level authentication */
+    auth?: unknown;
+}
+/**
+ * Postman Collection v2.1 JSON structure
+ */
+interface PostmanCollection {
+    info: {
+        name: string;
+        description: string;
+        schema: string;
+    };
+    item: PostmanItem[];
+    auth?: any;
+    variable?: Array<{
+        key: string;
+        value: string;
+        type: string;
+    }>;
+}
+interface PostmanItem {
+    name: string;
+    item?: PostmanItem[];
+    request?: PostmanRequest;
+    event?: PostmanEvent[];
+}
+interface PostmanRequest {
+    url: string | PostmanUrl;
+    method: string;
+    header: PostmanHeader[];
+    body?: PostmanBody;
+    description?: string;
+}
+interface PostmanUrl {
+    raw: string;
+    host: string[];
+    path: string[];
+    query?: Array<{
+        key: string;
+        value: string;
+    }>;
+}
+interface PostmanHeader {
+    key: string;
+    value: string;
+}
+interface PostmanBody {
+    mode: string;
+    raw?: string;
+    urlencoded?: Array<{
+        key: string;
+        value: string;
+    }>;
+    options?: any;
+}
+interface PostmanEvent {
+    listen: string;
+    script: {
+        exec: string[];
+        type: string;
+    };
+}
+/**
+ * Service for generating Postman Collections from test cases
+ */
+export declare class PostmanService {
+    /**
+     * Generates a Postman Collection v2.1 from test cases
+     *
+     * @param tests - Test cases to convert
+     * @param options - Generation options
+     * @returns Collection object with toJSON() method
+     */
+    generateCollection(tests: TestCase[], options: PostmanCollectionOptions): {
+        toJSON: () => PostmanCollection;
+    };
+    /**
+     * Groups tests by category and returns folder items
+     */
+    private groupTestsByCategory;
+    /**
+     * Creates a Postman request item from a test case
+     */
+    private createRequestItem;
+    /**
+     * Builds URL string from test case
+     */
+    private buildUrl;
+    /**
+     * Builds headers array from test case
+     */
+    private buildHeaders;
+    /**
+     * Builds request body from test case
+     */
+    private buildBody;
+    /**
+     * Generates Postman test script for validating responses
+     */
+    private generateTestScript;
+    /**
+     * Counts total requests in collection (including nested folders)
+     */
+    private countTotalRequests;
+}
+export {};
+//# sourceMappingURL=postman-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postman-service.d.ts","sourceRoot":"","sources":["../../../src/mcp/services/postman-service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAKrD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IAEb,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,gDAAgD;IAChD,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,8CAA8C;IAC9C,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,sCAAsC;IACtC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,UAAU,iBAAiB;IACzB,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChE;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,UAAU,cAAc;IACtB,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,UAAU;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/C;AAED,UAAU,aAAa;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,OAAO,CAAC,EAAE,GAAG,CAAC;CACf;AAED,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB;;;;;;OAMG;IACH,kBAAkB,CAChB,KAAK,EAAE,QAAQ,EAAE,EACjB,OAAO,EAAE,wBAAwB,GAChC;QAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;KAAE;IA8CtC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAqC5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkDzB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAyBhB;;OAEG;IACH,OAAO,CAAC,YAAY;IAoBpB;;OAEG;IACH,OAAO,CAAC,SAAS;IAsCjB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAsC1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAkB3B"}

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

@@ -0,0 +1,266 @@
+/**
+ * Postman Service - Converts test cases to Postman Collections
+ *
+ * Generates Postman Collection v2.1 JSON format manually
+ * compatible with Postman app and Newman CLI.
+ *
+ * @module mcp/services/postman-service
+ */
+import { createLogger } from '../../utils/logger.js';
+const log = createLogger('postman-service');
+/**
+ * Service for generating Postman Collections from test cases
+ */
+export class PostmanService {
+    /**
+     * Generates a Postman Collection v2.1 from test cases
+     *
+     * @param tests - Test cases to convert
+     * @param options - Generation options
+     * @returns Collection object with toJSON() method
+     */
+    generateCollection(tests, options) {
+        log.info('Generating Postman collection', {
+            testCount: tests.length,
+            collectionName: options.name,
+            groupByCategory: options.groupByCategory
+        });
+        // Create collection
+        const collection = {
+            info: {
+                name: options.name,
+                description: `Generated API test collection with ${tests.length} requests`,
+                schema: 'https://schema.getpostman.com/json/collection/v2.1.0/collection.json'
+            },
+            item: [],
+            auth: options.auth
+        };
+        // Add variables if baseUrl provided
+        if (options.baseUrl) {
+            collection.variable = [
+                {
+                    key: 'baseUrl',
+                    value: options.baseUrl,
+                    type: 'string'
+                }
+            ];
+        }
+        // Group by category or add flat
+        if (options.groupByCategory !== false) {
+            collection.item = this.groupTestsByCategory(tests, options);
+        }
+        else {
+            collection.item = tests.map(test => this.createRequestItem(test, options));
+        }
+        log.info('Postman collection generated', {
+            folderCount: collection.item.length,
+            totalRequests: this.countTotalRequests(collection)
+        });
+        return {
+            toJSON: () => collection
+        };
+    }
+    /**
+     * Groups tests by category and returns folder items
+     */
+    groupTestsByCategory(tests, options) {
+        const categoryFolders = new Map();
+        const categoryNames = {
+            'happy-path': '✅ Happy Path',
+            'edge-case': '⚡ Edge Cases',
+            'error-case': '❌ Error Cases',
+            'business-rule': '📋 Business Rules'
+        };
+        for (const test of tests) {
+            const category = test.category || 'other';
+            if (!categoryFolders.has(category)) {
+                categoryFolders.set(category, []);
+            }
+            const item = this.createRequestItem(test, options);
+            categoryFolders.get(category).push(item);
+        }
+        // Convert to folder structure
+        const folders = [];
+        for (const [category, items] of categoryFolders) {
+            const folderName = categoryNames[category] || category;
+            folders.push({
+                name: folderName,
+                item: items
+            });
+        }
+        return folders;
+    }
+    /**
+     * Creates a Postman request item from a test case
+     */
+    createRequestItem(test, options) {
+        // Build URL
+        const url = this.buildUrl(test, options.baseUrl);
+        // Build headers
+        const headers = this.buildHeaders(test);
+        // Build body
+        const body = this.buildBody(test);
+        // Create request
+        const request = {
+            url,
+            method: test.method.toUpperCase(),
+            header: headers,
+            description: test.description || `${test.method.toUpperCase()} ${test.path}`
+        };
+        if (body) {
+            request.body = body;
+        }
+        // Create item
+        const item = {
+            name: test.name,
+            request
+        };
+        // Add test scripts if enabled
+        if (options.includeTests !== false) {
+            const testScript = this.generateTestScript(test);
+            if (testScript) {
+                item.event = [
+                    {
+                        listen: 'test',
+                        script: {
+                            exec: testScript.split('\n'),
+                            type: 'text/javascript'
+                        }
+                    }
+                ];
+            }
+        }
+        return item;
+    }
+    /**
+     * Builds URL string from test case
+     */
+    buildUrl(test, baseUrl) {
+        // Replace path params
+        let path = test.path;
+        if (test.pathParams) {
+            for (const [key, value] of Object.entries(test.pathParams)) {
+                path = path.replace(`{${key}}`, String(value));
+            }
+        }
+        // Build full URL
+        let url = baseUrl
+            ? `{{baseUrl}}${path}`
+            : `https://api.example.com${path}`;
+        // Add query params
+        if (test.queryParams && Object.keys(test.queryParams).length > 0) {
+            const params = Object.entries(test.queryParams)
+                .map(([key, value]) => `${key}=${encodeURIComponent(String(value))}`)
+                .join('&');
+            url += `?${params}`;
+        }
+        return url;
+    }
+    /**
+     * Builds headers array from test case
+     */
+    buildHeaders(test) {
+        const headers = [];
+        if (test.headers) {
+            for (const [key, value] of Object.entries(test.headers)) {
+                headers.push({ key, value });
+            }
+        }
+        // Add Content-Type if body present and not already set
+        if (test.body && !test.headers?.['Content-Type']) {
+            headers.push({
+                key: 'Content-Type',
+                value: test.contentType || 'application/json'
+            });
+        }
+        return headers;
+    }
+    /**
+     * Builds request body from test case
+     */
+    buildBody(test) {
+        if (!test.body) {
+            return undefined;
+        }
+        const contentType = test.contentType || 'application/json';
+        if (contentType === 'application/json') {
+            return {
+                mode: 'raw',
+                raw: JSON.stringify(test.body, null, 2)
+            };
+        }
+        if (contentType === 'application/x-www-form-urlencoded') {
+            const urlencoded = [];
+            if (typeof test.body === 'object' && test.body !== null) {
+                for (const [key, value] of Object.entries(test.body)) {
+                    urlencoded.push({
+                        key,
+                        value: String(value)
+                    });
+                }
+            }
+            return {
+                mode: 'urlencoded',
+                urlencoded
+            };
+        }
+        // Default: raw
+        return {
+            mode: 'raw',
+            raw: typeof test.body === 'string' ? test.body : JSON.stringify(test.body)
+        };
+    }
+    /**
+     * Generates Postman test script for validating responses
+     */
+    generateTestScript(test) {
+        const scripts = [];
+        // Status code test
+        scripts.push(`pm.test("Status code is ${test.expectedStatus}", function () {`);
+        scripts.push(`    pm.response.to.have.status(${test.expectedStatus});`);
+        scripts.push(`});`);
+        scripts.push('');
+        // Response time test
+        scripts.push(`pm.test("Response time is less than 2000ms", function () {`);
+        scripts.push(`    pm.expect(pm.response.responseTime).to.be.below(2000);`);
+        scripts.push(`});`);
+        scripts.push('');
+        // Expected error message test
+        if (test.expectedError?.message) {
+            const expectedMsg = typeof test.expectedError.message === 'string'
+                ? test.expectedError.message
+                : 'error';
+            scripts.push(`pm.test("Response contains expected error message", function () {`);
+            scripts.push(`    const body = pm.response.json();`);
+            scripts.push(`    pm.expect(JSON.stringify(body)).to.include("${expectedMsg}");`);
+            scripts.push(`});`);
+            scripts.push('');
+        }
+        // Schema validation for happy-path
+        if (test.category === 'happy-path' && test.validateSchema !== false) {
+            scripts.push(`pm.test("Response has valid JSON body", function () {`);
+            scripts.push(`    pm.response.to.be.json;`);
+            scripts.push(`});`);
+        }
+        return scripts.join('\n');
+    }
+    /**
+     * Counts total requests in collection (including nested folders)
+     */
+    countTotalRequests(collection) {
+        let count = 0;
+        function countItems(items) {
+            for (const item of items) {
+                if (item.request) {
+                    count++;
+                }
+                if (item.item && Array.isArray(item.item)) {
+                    countItems(item.item);
+                }
+            }
+        }
+        countItems(collection.item);
+        return count;
+    }
+}
+//# sourceMappingURL=postman-service.js.map

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

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