@machina.ai/openapi-contract-tester 2.1.0

package/dist/validators/schema-validator.d.ts

@@ -0,0 +1,174 @@
+/**
+ * Schema Validator
+ *
+ * Validates JSON data against JSON Schema using AJV (Another JSON Validator).
+ * Supports OpenAPI 3.x schema extensions and provides detailed error reporting.
+ *
+ * @module validators/schema-validator
+ */
+import Ajv from 'ajv';
+import type { OpenAPIV3 } from 'openapi-types';
+import type { ValidationResult } from '../types/index.js';
+/**
+ * Gets or creates the AJV validator instance
+ *
+ * The instance is created with:
+ * - All standard JSON Schema formats (email, uri, uuid, date-time, etc.)
+ * - Strict mode disabled to support OpenAPI extensions
+ * - All errors reported (not just the first one)
+ *
+ * @returns Configured AJV instance
+ *
+ * @example
+ * ```typescript
+ * const ajv = getAjvInstance();
+ * const validate = ajv.compile(schema);
+ * const valid = validate(data);
+ * ```
+ */
+export declare function getAjvInstance(): Ajv;
+/**
+ * Validates data against a JSON Schema
+ *
+ * @param data - Data to validate
+ * @param schema - JSON Schema to validate against
+ * @returns Validation result with success status and errors
+ *
+ * @example
+ * ```typescript
+ * const schema = {
+ *   type: 'object',
+ *   required: ['email', 'name'],
+ *   properties: {
+ *     email: { type: 'string', format: 'email' },
+ *     name: { type: 'string', minLength: 1 }
+ *   }
+ * };
+ *
+ * const result = validateSchema({ email: 'test@example.com', name: 'John' }, schema);
+ * if (result.valid) {
+ *   console.log('Valid!');
+ * } else {
+ *   console.error('Validation errors:', result.errors);
+ * }
+ * ```
+ */
+export declare function validateSchema(data: unknown, schema: OpenAPIV3.SchemaObject): ValidationResult;
+/**
+ * Validates request body data against an endpoint's request body schema
+ *
+ * @param data - Request body data to validate
+ * @param requestBodySchema - Request body schema from OpenAPI spec
+ * @returns Validation result
+ *
+ * @example
+ * ```typescript
+ * const endpoint = extractEndpoints(spec).find(e => e.path === '/users' && e.method === 'POST');
+ * const requestData = { email: 'test@example.com', name: 'John' };
+ *
+ * const result = validateRequestBody(requestData, endpoint.requestBody);
+ * if (!result.valid) {
+ *   console.error('Invalid request:', result.errors);
+ * }
+ * ```
+ */
+export declare function validateRequestBody(data: unknown, requestBodySchema: OpenAPIV3.SchemaObject | undefined): ValidationResult;
+/**
+ * Validates response data against an endpoint's response schema
+ *
+ * @param data - Response data to validate
+ * @param responseSchema - Response schema from OpenAPI spec
+ * @returns Validation result
+ *
+ * @example
+ * ```typescript
+ * const endpoint = extractEndpoints(spec).find(e => e.path === '/users' && e.method === 'GET');
+ * const responseData = [
+ *   { id: 1, email: 'user1@example.com', name: 'User 1' },
+ *   { id: 2, email: 'user2@example.com', name: 'User 2' }
+ * ];
+ *
+ * const result = validateResponseBody(responseData, endpoint.responses[200]);
+ * if (!result.valid) {
+ *   console.error('Invalid response:', result.errors);
+ * }
+ * ```
+ */
+export declare function validateResponseBody(data: unknown, responseSchema: OpenAPIV3.SchemaObject | undefined): ValidationResult;
+/**
+ * Validates path parameters against their schemas
+ *
+ * @param params - Path parameters object
+ * @param paramSchemas - Array of parameter definitions from OpenAPI spec
+ * @returns Validation result
+ *
+ * @example
+ * ```typescript
+ * const endpoint = extractEndpoints(spec).find(e => e.path === '/users/{id}');
+ * const params = { id: '123' };
+ *
+ * const result = validatePathParams(params, endpoint.pathParams);
+ * if (!result.valid) {
+ *   console.error('Invalid path params:', result.errors);
+ * }
+ * ```
+ */
+export declare function validatePathParams(params: Record<string, string | number>, paramSchemas: OpenAPIV3.ParameterObject[]): ValidationResult;
+/**
+ * Validates query parameters against their schemas
+ *
+ * @param params - Query parameters object
+ * @param paramSchemas - Array of query parameter definitions from OpenAPI spec
+ * @returns Validation result
+ *
+ * @example
+ * ```typescript
+ * const endpoint = extractEndpoints(spec).find(e => e.path === '/users');
+ * const queryParams = { page: 1, limit: 10, sortBy: 'name' };
+ *
+ * const result = validateQueryParams(queryParams, endpoint.queryParams);
+ * if (!result.valid) {
+ *   console.error('Invalid query params:', result.errors);
+ * }
+ * ```
+ */
+export declare function validateQueryParams(params: Record<string, string | number | boolean>, paramSchemas: OpenAPIV3.ParameterObject[]): ValidationResult;
+/**
+ * Checks if a value matches the expected type
+ *
+ * @param value - Value to check
+ * @param expectedType - Expected JSON Schema type
+ * @returns True if value matches expected type
+ *
+ * @example
+ * ```typescript
+ * isType(123, 'integer') // true
+ * isType('hello', 'string') // true
+ * isType([], 'array') // true
+ * isType({}, 'object') // true
+ * isType(true, 'boolean') // true
+ * isType(3.14, 'number') // true
+ * isType(123, 'string') // false
+ * ```
+ */
+export declare function isType(value: unknown, expectedType: string): boolean;
+/**
+ * Formats validation errors into a human-readable string
+ *
+ * @param errors - Array of validation errors
+ * @returns Formatted error message
+ *
+ * @example
+ * ```typescript
+ * const result = validateSchema(data, schema);
+ * if (!result.valid) {
+ *   console.error(formatValidationErrors(result.errors));
+ * }
+ * ```
+ */
+export declare function formatValidationErrors(errors: Array<{
+    field: string;
+    message: string;
+    code?: string;
+}>): string;
+//# sourceMappingURL=schema-validator.d.ts.map

package/dist/validators/schema-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.d.ts","sourceRoot":"","sources":["../../src/validators/schema-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,GAAG,MAAM,KAAK,CAAC;AAEtB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAO1D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,IAAI,GAAG,CAcpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,SAAS,CAAC,YAAY,GAC7B,gBAAgB,CA0DlB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,OAAO,EACb,iBAAiB,EAAE,SAAS,CAAC,YAAY,GAAG,SAAS,GACpD,gBAAgB,CAUlB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,OAAO,EACb,cAAc,EAAE,SAAS,CAAC,YAAY,GAAG,SAAS,GACjD,gBAAgB,CAUlB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EACvC,YAAY,EAAE,SAAS,CAAC,eAAe,EAAE,GACxC,gBAAgB,CAmClB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EACjD,YAAY,EAAE,SAAS,CAAC,eAAe,EAAE,GACxC,gBAAgB,CAmClB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAmBpE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC/D,MAAM,CAQR"}

package/dist/validators/schema-validator.js

@@ -0,0 +1,340 @@
+/**
+ * Schema Validator
+ *
+ * Validates JSON data against JSON Schema using AJV (Another JSON Validator).
+ * Supports OpenAPI 3.x schema extensions and provides detailed error reporting.
+ *
+ * @module validators/schema-validator
+ */
+import Ajv from 'ajv';
+import addFormats from 'ajv-formats';
+/**
+ * Schema validator instance using AJV
+ */
+let ajvInstance = null;
+/**
+ * Gets or creates the AJV validator instance
+ *
+ * The instance is created with:
+ * - All standard JSON Schema formats (email, uri, uuid, date-time, etc.)
+ * - Strict mode disabled to support OpenAPI extensions
+ * - All errors reported (not just the first one)
+ *
+ * @returns Configured AJV instance
+ *
+ * @example
+ * ```typescript
+ * const ajv = getAjvInstance();
+ * const validate = ajv.compile(schema);
+ * const valid = validate(data);
+ * ```
+ */
+export function getAjvInstance() {
+    if (!ajvInstance) {
+        ajvInstance = new Ajv({
+            allErrors: true, // Report all errors, not just the first
+            strict: false, // Allow OpenAPI extensions like 'nullable', 'discriminator'
+            validateFormats: true, // Validate format keywords
+            coerceTypes: false, // Don't coerce types (strict validation)
+        });
+        // Add format validators (email, uri, uuid, date-time, etc.)
+        addFormats(ajvInstance);
+    }
+    return ajvInstance;
+}
+/**
+ * Validates data against a JSON Schema
+ *
+ * @param data - Data to validate
+ * @param schema - JSON Schema to validate against
+ * @returns Validation result with success status and errors
+ *
+ * @example
+ * ```typescript
+ * const schema = {
+ *   type: 'object',
+ *   required: ['email', 'name'],
+ *   properties: {
+ *     email: { type: 'string', format: 'email' },
+ *     name: { type: 'string', minLength: 1 }
+ *   }
+ * };
+ *
+ * const result = validateSchema({ email: 'test@example.com', name: 'John' }, schema);
+ * if (result.valid) {
+ *   console.log('Valid!');
+ * } else {
+ *   console.error('Validation errors:', result.errors);
+ * }
+ * ```
+ */
+export function validateSchema(data, schema) {
+    const ajv = getAjvInstance();
+    try {
+        // Compile schema
+        const validate = ajv.compile(schema);
+        // Validate data
+        const valid = validate(data);
+        if (valid) {
+            return {
+                valid: true,
+                errors: [],
+            };
+        }
+        // Format errors
+        const errors = (validate.errors || []).map(error => {
+            const path = error.instancePath || 'root';
+            const message = error.message || 'Unknown error';
+            // Build detailed error message
+            let detailedMessage = `${path}: ${message}`;
+            if (error.params) {
+                // Add parameter details
+                const params = Object.entries(error.params)
+                    .map(([key, value]) => `${key}=${JSON.stringify(value)}`)
+                    .join(', ');
+                detailedMessage += ` (${params})`;
+            }
+            return {
+                field: path.replace(/^\//, '').replace(/\//g, '.') || 'root',
+                message: detailedMessage,
+                code: error.keyword,
+                value: error.data,
+            };
+        });
+        return {
+            valid: false,
+            errors,
+        };
+    }
+    catch (error) {
+        // Schema compilation error
+        return {
+            valid: false,
+            errors: [
+                {
+                    field: 'schema',
+                    message: `Invalid schema: ${error instanceof Error ? error.message : String(error)}`,
+                    code: 'SCHEMA_ERROR',
+                },
+            ],
+        };
+    }
+}
+/**
+ * Validates request body data against an endpoint's request body schema
+ *
+ * @param data - Request body data to validate
+ * @param requestBodySchema - Request body schema from OpenAPI spec
+ * @returns Validation result
+ *
+ * @example
+ * ```typescript
+ * const endpoint = extractEndpoints(spec).find(e => e.path === '/users' && e.method === 'POST');
+ * const requestData = { email: 'test@example.com', name: 'John' };
+ *
+ * const result = validateRequestBody(requestData, endpoint.requestBody);
+ * if (!result.valid) {
+ *   console.error('Invalid request:', result.errors);
+ * }
+ * ```
+ */
+export function validateRequestBody(data, requestBodySchema) {
+    if (!requestBodySchema) {
+        // No schema to validate against - consider valid
+        return {
+            valid: true,
+            errors: [],
+        };
+    }
+    return validateSchema(data, requestBodySchema);
+}
+/**
+ * Validates response data against an endpoint's response schema
+ *
+ * @param data - Response data to validate
+ * @param responseSchema - Response schema from OpenAPI spec
+ * @returns Validation result
+ *
+ * @example
+ * ```typescript
+ * const endpoint = extractEndpoints(spec).find(e => e.path === '/users' && e.method === 'GET');
+ * const responseData = [
+ *   { id: 1, email: 'user1@example.com', name: 'User 1' },
+ *   { id: 2, email: 'user2@example.com', name: 'User 2' }
+ * ];
+ *
+ * const result = validateResponseBody(responseData, endpoint.responses[200]);
+ * if (!result.valid) {
+ *   console.error('Invalid response:', result.errors);
+ * }
+ * ```
+ */
+export function validateResponseBody(data, responseSchema) {
+    if (!responseSchema) {
+        // No schema to validate against - consider valid
+        return {
+            valid: true,
+            errors: [],
+        };
+    }
+    return validateSchema(data, responseSchema);
+}
+/**
+ * Validates path parameters against their schemas
+ *
+ * @param params - Path parameters object
+ * @param paramSchemas - Array of parameter definitions from OpenAPI spec
+ * @returns Validation result
+ *
+ * @example
+ * ```typescript
+ * const endpoint = extractEndpoints(spec).find(e => e.path === '/users/{id}');
+ * const params = { id: '123' };
+ *
+ * const result = validatePathParams(params, endpoint.pathParams);
+ * if (!result.valid) {
+ *   console.error('Invalid path params:', result.errors);
+ * }
+ * ```
+ */
+export function validatePathParams(params, paramSchemas) {
+    const errors = [];
+    for (const paramDef of paramSchemas) {
+        const paramName = paramDef.name;
+        const paramValue = params[paramName];
+        // Check if required parameter is present
+        if (paramDef.required && (paramValue === undefined || paramValue === null)) {
+            errors.push({
+                field: paramName,
+                message: `Required path parameter '${paramName}' is missing`,
+                code: 'REQUIRED',
+            });
+            continue;
+        }
+        // Validate against schema if present
+        if (paramDef.schema && !('$ref' in paramDef.schema) && paramValue !== undefined) {
+            const schema = paramDef.schema;
+            const result = validateSchema(paramValue, schema);
+            if (!result.valid) {
+                errors.push(...result.errors.map((err) => ({
+                    ...err,
+                    field: `${paramName}.${err.field}`,
+                })));
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Validates query parameters against their schemas
+ *
+ * @param params - Query parameters object
+ * @param paramSchemas - Array of query parameter definitions from OpenAPI spec
+ * @returns Validation result
+ *
+ * @example
+ * ```typescript
+ * const endpoint = extractEndpoints(spec).find(e => e.path === '/users');
+ * const queryParams = { page: 1, limit: 10, sortBy: 'name' };
+ *
+ * const result = validateQueryParams(queryParams, endpoint.queryParams);
+ * if (!result.valid) {
+ *   console.error('Invalid query params:', result.errors);
+ * }
+ * ```
+ */
+export function validateQueryParams(params, paramSchemas) {
+    const errors = [];
+    for (const paramDef of paramSchemas) {
+        const paramName = paramDef.name;
+        const paramValue = params[paramName];
+        // Check if required parameter is present
+        if (paramDef.required && (paramValue === undefined || paramValue === null)) {
+            errors.push({
+                field: paramName,
+                message: `Required query parameter '${paramName}' is missing`,
+                code: 'REQUIRED',
+            });
+            continue;
+        }
+        // Validate against schema if present
+        if (paramDef.schema && !('$ref' in paramDef.schema) && paramValue !== undefined) {
+            const schema = paramDef.schema;
+            const result = validateSchema(paramValue, schema);
+            if (!result.valid) {
+                errors.push(...result.errors.map((err) => ({
+                    ...err,
+                    field: `${paramName}.${err.field}`,
+                })));
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Checks if a value matches the expected type
+ *
+ * @param value - Value to check
+ * @param expectedType - Expected JSON Schema type
+ * @returns True if value matches expected type
+ *
+ * @example
+ * ```typescript
+ * isType(123, 'integer') // true
+ * isType('hello', 'string') // true
+ * isType([], 'array') // true
+ * isType({}, 'object') // true
+ * isType(true, 'boolean') // true
+ * isType(3.14, 'number') // true
+ * isType(123, 'string') // false
+ * ```
+ */
+export function isType(value, expectedType) {
+    switch (expectedType) {
+        case 'string':
+            return typeof value === 'string';
+        case 'number':
+            return typeof value === 'number' && !Number.isNaN(value);
+        case 'integer':
+            return typeof value === 'number' && Number.isInteger(value);
+        case 'boolean':
+            return typeof value === 'boolean';
+        case 'array':
+            return Array.isArray(value);
+        case 'object':
+            return typeof value === 'object' && value !== null && !Array.isArray(value);
+        case 'null':
+            return value === null;
+        default:
+            return false;
+    }
+}
+/**
+ * Formats validation errors into a human-readable string
+ *
+ * @param errors - Array of validation errors
+ * @returns Formatted error message
+ *
+ * @example
+ * ```typescript
+ * const result = validateSchema(data, schema);
+ * if (!result.valid) {
+ *   console.error(formatValidationErrors(result.errors));
+ * }
+ * ```
+ */
+export function formatValidationErrors(errors) {
+    if (errors.length === 0) {
+        return 'No errors';
+    }
+    return errors
+        .map((err, index) => `${index + 1}. ${err.field}: ${err.message}`)
+        .join('\n');
+}
+//# sourceMappingURL=schema-validator.js.map

package/dist/validators/schema-validator.js.map

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

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@machina.ai/openapi-contract-tester",
+  "version": "2.1.0",
+  "description": "MCP Server for comprehensive AI-powered API testing from OpenAPI specifications",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "openapi-contract-tester": "./dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    ".env.example"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "jest --config jest.config.cjs",
+    "test:watch": "jest --config jest.config.cjs --watch",
+    "test:coverage": "jest --config jest.config.cjs --coverage",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "format": "prettier --write \"src/**/*.ts\""
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "openapi",
+    "swagger",
+    "api-testing",
+    "ai-testing",
+    "mcp-server",
+    "playwright",
+    "rest-api",
+    "testing",
+    "automation",
+    "auto-repair"
+  ],
+  "author": "Daniel Jahziel Martinez",
+  "license": "UNLICENSED",
+  "dependencies": {
+    "@apidevtools/swagger-parser": "^10.1.0",
+    "@faker-js/faker": "^9.2.0",
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "@playwright/test": "^1.48.0",
+    "@toon-format/toon": "^1.0.0",
+    "@types/postman-collection": "^3.5.11",
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "chalk": "^5.3.0",
+    "cli-table3": "^0.6.5",
+    "openapi-types": "^12.1.3",
+    "papaparse": "^5.5.3",
+    "postman-collection": "^5.2.1",
+    "randexp": "^0.5.3",
+    "swagger2openapi": "^7.0.8",
+    "xlsx": "^0.18.5",
+    "yaml": "^2.6.1",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.10.2",
+    "@types/papaparse": "^5.5.0",
+    "@typescript-eslint/eslint-plugin": "^8.19.1",
+    "@typescript-eslint/parser": "^8.19.1",
+    "eslint": "^9.17.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.2.5",
+    "typescript": "^5.7.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}