@machina.ai/openapi-contract-tester 2.1.0

package/dist/business-rules/business-rules-analyzer.js

@@ -0,0 +1,363 @@
+/**
+ * Business Rules Analyzer
+ *
+ * Analyzes documentation (User Stories, Gherkin, requirements) and extracts
+ * business rules automatically. Supports multiple formats including:
+ * - Markdown with acceptance criteria
+ * - Gherkin/BDD feature files
+ * - Free text requirements
+ *
+ * @module business-rules/business-rules-analyzer
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { extractEndpointsFromContent, extractAgeValidationRules, extractEmailValidationRules, extractPasswordValidationRules, extractUniquenessRules, extractPatternValidationRules, } from './extractors/rule-extractors.js';
+/**
+ * Default file extensions to analyze
+ */
+const DEFAULT_EXTENSIONS = ['.md', '.feature', '.txt', '.gherkin'];
+/**
+ * Analyzes documentation files and extracts business rules
+ *
+ * @param docsPath - Directory containing documentation files
+ * @param outputPath - Where to write business-rules.yml
+ * @param options - Analysis options
+ * @returns Analysis result with extracted rules
+ *
+ * @example
+ * ```typescript
+ * const result = await analyzeBusinessRules('./docs', './business-rules.yml', {
+ *   generateIds: true,
+ *   includeExamples: true
+ * });
+ * console.log(`Extracted ${result.rulesExtracted} rules`);
+ * ```
+ */
+export async function analyzeBusinessRules(docsPath, outputPath, options = {}) {
+    const { includeExamples = true, generateIds = true, fileExtensions = DEFAULT_EXTENSIONS, encoding = 'utf-8', } = options;
+    try {
+        // Read all documentation files
+        const files = await findDocumentationFiles(docsPath, fileExtensions);
+        if (files.length === 0) {
+            return {
+                success: false,
+                rulesExtracted: 0,
+                rulesFile: outputPath,
+                rules: [],
+                summary: {
+                    filesAnalyzed: 0,
+                    rulesExtracted: 0,
+                    endpointsCovered: 0,
+                },
+                errors: [`No documentation files found in ${docsPath}`],
+            };
+        }
+        // Extract rules from each file
+        const allRules = [];
+        let ruleCounter = 1;
+        for (const filePath of files) {
+            const content = await fs.readFile(filePath, encoding);
+            const rules = await extractRulesFromDocument(content, filePath, includeExamples);
+            // Generate IDs if requested
+            for (const rule of rules) {
+                if (generateIds && !rule.id) {
+                    rule.id = `BR-${String(ruleCounter).padStart(3, '0')}`;
+                    ruleCounter++;
+                }
+                allRules.push(rule);
+            }
+        }
+        // Create business rules document
+        const document = {
+            version: '1.0',
+            generated: new Date(),
+            source: docsPath,
+            rules: allRules,
+            metadata: {
+                filesAnalyzed: files.length,
+                rulesExtracted: allRules.length,
+                endpointsCovered: countUniqueEndpoints(allRules),
+            },
+        };
+        // Write to YAML file
+        await writeBusinessRulesYAML(document, outputPath);
+        return {
+            success: true,
+            rulesExtracted: allRules.length,
+            rulesFile: outputPath,
+            rules: allRules,
+            summary: document.metadata,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            rulesExtracted: 0,
+            rulesFile: outputPath,
+            rules: [],
+            summary: {
+                filesAnalyzed: 0,
+                rulesExtracted: 0,
+                endpointsCovered: 0,
+            },
+            errors: [error instanceof Error ? error.message : String(error)],
+        };
+    }
+}
+/**
+ * Finds all documentation files in a directory or returns single file if path is a file
+ *
+ * @param dirPath - Directory or file path to search
+ * @param extensions - File extensions to include
+ * @returns Array of file paths
+ */
+async function findDocumentationFiles(dirPath, extensions) {
+    const files = [];
+    // Check if path is a file or directory
+    const stats = await fs.stat(dirPath);
+    // If it's a file, return it directly if extension matches
+    if (stats.isFile()) {
+        const ext = path.extname(dirPath);
+        if (extensions.includes(ext)) {
+            return [dirPath];
+        }
+        return [];
+    }
+    // If it's a directory, traverse it
+    async function traverse(currentPath) {
+        const entries = await fs.readdir(currentPath, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(currentPath, entry.name);
+            if (entry.isDirectory()) {
+                await traverse(fullPath);
+            }
+            else if (entry.isFile()) {
+                const ext = path.extname(entry.name).toLowerCase();
+                if (extensions.includes(ext)) {
+                    files.push(fullPath);
+                }
+            }
+        }
+    }
+    // Only traverse if it's a directory (file case handled above)
+    if (stats.isDirectory()) {
+        await traverse(dirPath);
+    }
+    return files;
+}
+/**
+ * Extracts business rules from a single document
+ *
+ * @param content - Document content
+ * @param filePath - Source file path
+ * @param includeExamples - Whether to extract examples
+ * @returns Array of extracted rules
+ */
+async function extractRulesFromDocument(content, filePath, _includeExamples) {
+    const rules = [];
+    // Extract all endpoints mentioned in the document
+    const endpoints = extractEndpointsFromContent(content);
+    // Extract age validation rules
+    const ageRules = extractAgeValidationRules(content, filePath, endpoints);
+    rules.push(...ageRules);
+    // Extract email validation rules
+    const emailRules = extractEmailValidationRules(content, filePath, endpoints);
+    rules.push(...emailRules);
+    // Extract password validation rules
+    const passwordRules = extractPasswordValidationRules(content, filePath, endpoints);
+    rules.push(...passwordRules);
+    // Extract uniqueness rules
+    const uniqueRules = extractUniquenessRules(content, filePath, endpoints);
+    rules.push(...uniqueRules);
+    // Extract pattern validation rules (no spaces, etc.)
+    const patternRules = extractPatternValidationRules(content, filePath, endpoints);
+    rules.push(...patternRules);
+    return rules;
+}
+// extractEndpoints, extractAgeValidationRules, extractEmailValidationRules,
+// extractPasswordValidationRules, extractUniquenessRules, extractPatternValidationRules
+// are now in extractors/rule-extractors.ts
+/**
+ * Counts unique endpoints across all rules
+ *
+ * @param rules - Array of business rules
+ * @returns Number of unique endpoints
+ */
+function countUniqueEndpoints(rules) {
+    const unique = new Set(rules.map((r) => r.endpoint));
+    return unique.size;
+}
+/**
+ * Writes business rules document to YAML file
+ *
+ * @param document - Business rules document
+ * @param outputPath - Output file path
+ */
+async function writeBusinessRulesYAML(document, outputPath) {
+    // Convert to YAML-like format manually (simpler than adding yaml dependency)
+    let yaml = `version: "${document.version}"\n`;
+    yaml += `generated: ${document.generated.toISOString()}\n`;
+    yaml += `source: ${typeof document.source === 'string' ? document.source : JSON.stringify(document.source)}\n\n`;
+    if (document.metadata) {
+        yaml += `metadata:\n`;
+        yaml += `  filesAnalyzed: ${document.metadata.filesAnalyzed}\n`;
+        yaml += `  rulesExtracted: ${document.metadata.rulesExtracted}\n`;
+        yaml += `  endpointsCovered: ${document.metadata.endpointsCovered}\n\n`;
+    }
+    yaml += `rules:\n`;
+    for (const rule of document.rules) {
+        yaml += `  - id: ${rule.id}\n`;
+        yaml += `    source: ${rule.source}\n`;
+        yaml += `    endpoint: ${rule.endpoint}\n`;
+        if (rule.method)
+            yaml += `    method: ${rule.method}\n`;
+        if (rule.path)
+            yaml += `    path: ${rule.path}\n`;
+        if (rule.field)
+            yaml += `    field: ${rule.field}\n`;
+        yaml += `    description: "${rule.description}"\n`;
+        if (rule.validations.length > 0) {
+            yaml += `    validations:\n`;
+            for (const validation of rule.validations) {
+                yaml += `      - type: ${validation.type}\n`;
+                if (validation.value !== undefined) {
+                    yaml += `        value: ${JSON.stringify(validation.value)}\n`;
+                }
+                if (validation.format)
+                    yaml += `        format: ${validation.format}\n`;
+                if (validation.regex)
+                    yaml += `        regex: "${validation.regex}"\n`;
+                if (validation.errorStatus)
+                    yaml += `        errorStatus: ${validation.errorStatus}\n`;
+                if (validation.errorMessage)
+                    yaml += `        errorMessage: "${validation.errorMessage}"\n`;
+            }
+        }
+        if (rule.priority)
+            yaml += `    priority: ${rule.priority}\n`;
+        if (rule.tags && rule.tags.length > 0) {
+            yaml += `    tags: [${rule.tags.map(t => `"${t}"`).join(', ')}]\n`;
+        }
+        yaml += `\n`;
+    }
+    // Ensure output directory exists
+    const outputDir = path.dirname(outputPath);
+    await fs.mkdir(outputDir, { recursive: true });
+    await fs.writeFile(outputPath, yaml, 'utf-8');
+}
+/**
+ * Reads and parses a business-rules.yml file
+ *
+ * @param filePath - Path to business-rules.yml
+ * @returns Parsed business rules document
+ *
+ * @example
+ * ```typescript
+ * const document = await readBusinessRulesYAML('./business-rules.yml');
+ * console.log(`Loaded ${document.rules.length} rules`);
+ * ```
+ */
+export async function readBusinessRulesYAML(filePath) {
+    const content = await fs.readFile(filePath, 'utf-8');
+    // Simple YAML parser (basic implementation)
+    const lines = content.split('\n');
+    const document = {
+        version: '1.0',
+        generated: new Date(),
+        source: '',
+        rules: [],
+    };
+    let currentRule = null;
+    let currentValidation = null;
+    let inRules = false;
+    let inValidations = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith('version:')) {
+            document.version = trimmed.split(':')[1].trim().replace(/"/g, '');
+        }
+        else if (trimmed.startsWith('generated:')) {
+            document.generated = new Date(trimmed.split(':').slice(1).join(':').trim());
+        }
+        else if (trimmed.startsWith('source:')) {
+            document.source = trimmed.split(':')[1].trim();
+        }
+        else if (trimmed === 'rules:') {
+            inRules = true;
+        }
+        else if (inRules && trimmed.startsWith('- id:')) {
+            // Save previous rule
+            if (currentRule && currentRule.id) {
+                document.rules.push(currentRule);
+            }
+            currentRule = {
+                id: trimmed.split(':')[1].trim(),
+                source: '',
+                endpoint: '',
+                description: '',
+                validations: [],
+            };
+            inValidations = false;
+        }
+        else if (currentRule && trimmed.startsWith('source:')) {
+            currentRule.source = trimmed.split(':')[1].trim();
+        }
+        else if (currentRule && trimmed.startsWith('endpoint:')) {
+            currentRule.endpoint = trimmed.split(':').slice(1).join(':').trim();
+        }
+        else if (currentRule && trimmed.startsWith('method:')) {
+            currentRule.method = trimmed.split(':')[1].trim();
+        }
+        else if (currentRule && trimmed.startsWith('path:')) {
+            currentRule.path = trimmed.split(':').slice(1).join(':').trim();
+        }
+        else if (currentRule && trimmed.startsWith('field:')) {
+            currentRule.field = trimmed.split(':')[1].trim();
+        }
+        else if (currentRule && trimmed.startsWith('description:')) {
+            currentRule.description = trimmed.split(':').slice(1).join(':').trim().replace(/"/g, '');
+        }
+        else if (currentRule && trimmed === 'validations:') {
+            inValidations = true;
+        }
+        else if (inValidations && trimmed.startsWith('- type:')) {
+            // Save previous validation
+            if (currentValidation && currentValidation.type) {
+                currentRule.validations.push(currentValidation);
+            }
+            currentValidation = {
+                type: trimmed.split(':')[1].trim(),
+            };
+        }
+        else if (currentValidation && trimmed.startsWith('value:')) {
+            const valueStr = trimmed.split(':').slice(1).join(':').trim();
+            try {
+                currentValidation.value = JSON.parse(valueStr);
+            }
+            catch {
+                currentValidation.value = valueStr;
+            }
+        }
+        else if (currentValidation && trimmed.startsWith('format:')) {
+            currentValidation.format = trimmed.split(':')[1].trim();
+        }
+        else if (currentValidation && trimmed.startsWith('regex:')) {
+            currentValidation.regex = trimmed.split(':').slice(1).join(':').trim().replace(/"/g, '');
+        }
+        else if (currentValidation && trimmed.startsWith('errorStatus:')) {
+            currentValidation.errorStatus = parseInt(trimmed.split(':')[1].trim(), 10);
+        }
+        else if (currentValidation && trimmed.startsWith('errorMessage:')) {
+            currentValidation.errorMessage = trimmed.split(':').slice(1).join(':').trim().replace(/"/g, '');
+        }
+    }
+    // Save last validation and rule
+    if (currentValidation && currentValidation.type) {
+        currentRule.validations.push(currentValidation);
+    }
+    if (currentRule && currentRule.id) {
+        document.rules.push(currentRule);
+    }
+    return document;
+}
+//# sourceMappingURL=business-rules-analyzer.js.map

package/dist/business-rules/business-rules-analyzer.js.map

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

package/dist/business-rules/business-rules-generator.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Business Rules Test Generator
+ *
+ * Generates test cases from business rules (business-rules.yml).
+ * Creates both positive (valid) and negative (invalid) test cases
+ * for each business rule validation.
+ *
+ * @module business-rules/business-rules-generator
+ */
+import type { BusinessRulesGeneratorOptions, BusinessRulesTestsResult, TestCase, ParsedEndpoint } from '../types/index.js';
+/**
+ * Generates test cases from a business rules document
+ *
+ * @param rulesPath - Path to business-rules.yml file
+ * @param endpoints - Parsed OpenAPI endpoints for schema reference
+ * @param options - Generation options
+ * @returns Generated tests result
+ *
+ * @example
+ * ```typescript
+ * const result = await generateBusinessRulesTests(
+ *   './business-rules.yml',
+ *   endpoints,
+ *   { generatePositive: true, generateNegative: true, seed: 42 }
+ * );
+ * console.log(`Generated ${result.summary.total} business rule tests`);
+ * ```
+ */
+export declare function generateBusinessRulesTests(rulesPath: string, endpoints: ParsedEndpoint[], options?: BusinessRulesGeneratorOptions): Promise<BusinessRulesTestsResult>;
+/**
+ * Generates test cases from a normalized PRD document
+ *
+ * @param endpoints - Parsed OpenAPI endpoints
+ * @param prd - Normalized PRD document
+ * @param options - Generation options
+ * @returns Array of generated test cases
+ *
+ * @example
+ * ```typescript
+ * const tests = generateBusinessRuleTestsFromPrd(endpoints, prd, { seed: 42 });
+ * console.log(`Generated ${tests.length} business rule tests from PRD`);
+ * ```
+ */
+export declare function generateBusinessRuleTestsFromPrd(endpoints: ParsedEndpoint[], prd: {
+    businessRules: Array<{
+        id?: string;
+        name: string;
+        description: string;
+        condition: string;
+        expectedOutcome: string;
+        relatedEndpoints?: string[];
+    }>;
+    apiRequirements: Array<{
+        endpoint?: string;
+        method?: string;
+        description: string;
+        expectedStatus?: number;
+    }>;
+}, options?: {
+    seed?: number;
+}): TestCase[];
+/**
+ * Combines business rule tests with technical tests
+ *
+ * @param businessTests - Tests from business rules
+ * @param technicalTests - Tests from OpenAPI (happy/edge/error)
+ * @returns Combined result with totals
+ *
+ * @example
+ * ```typescript
+ * const combined = combineTests(businessTests, technicalTests);
+ * console.log(`Total: ${combined.summary.combined.total} tests`);
+ * console.log(`  Technical: ${combined.summary.combined.technical}`);
+ * console.log(`  Business: ${combined.summary.combined.business}`);
+ * ```
+ */
+export declare function combineTests(businessTests: BusinessRulesTestsResult, technicalTests: TestCase[]): BusinessRulesTestsResult;
+//# sourceMappingURL=business-rules-generator.d.ts.map

package/dist/business-rules/business-rules-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"business-rules-generator.d.ts","sourceRoot":"","sources":["../../src/business-rules/business-rules-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAEV,6BAA6B,EAC7B,wBAAwB,EACxB,QAAQ,EACR,cAAc,EAEf,MAAM,mBAAmB,CAAC;AAQ3B;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,0BAA0B,CAC9C,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,cAAc,EAAE,EAC3B,OAAO,GAAE,6BAAkC,GAC1C,OAAO,CAAC,wBAAwB,CAAC,CAuEnC;AAiHD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,cAAc,EAAE,EAC3B,GAAG,EAAE;IAAE,aAAa,EAAE,KAAK,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAAC,eAAe,EAAE,KAAK,CAAC;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,EACxQ,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9B,QAAQ,EAAE,CA6CZ;AAgHD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,aAAa,EAAE,wBAAwB,EACvC,cAAc,EAAE,QAAQ,EAAE,GACzB,wBAAwB,CAU1B"}