@machina.ai/openapi-contract-tester 2.1.0

package/dist/parsers/visitors/auth-visitor.js

@@ -0,0 +1,116 @@
+/**
+ * Auth Inference Visitor
+ *
+ * Infers authentication configuration from OpenAPI security schemes.
+ * Implements the Visitor pattern for spec-level auth analysis.
+ *
+ * @module parsers/visitors/auth-visitor
+ */
+import { extractSecuritySchemes } from '../endpoint-extractor.js';
+/**
+ * Infers authentication configuration from OpenAPI security schemes.
+ *
+ * Automatically detects OAuth2, Bearer, API Key, and Basic auth from the spec
+ * and constructs the appropriate AuthConfig using provided credentials.
+ *
+ * @param spec - Parsed OpenAPI specification
+ * @param credentials - User-provided credentials
+ * @returns AuthConfig object or undefined if no auth detected
+ */
+export function inferAuthFromSpec(spec, credentials) {
+    const securitySchemes = extractSecuritySchemes(spec);
+    if (Object.keys(securitySchemes).length === 0) {
+        return undefined;
+    }
+    const schemeName = Object.keys(securitySchemes)[0];
+    const scheme = securitySchemes[schemeName];
+    // OAuth2 - Extract tokenUrl from spec, use credentials from user
+    if (scheme.type === 'oauth2' && scheme.flows) {
+        const flows = scheme.flows;
+        if (flows.password && credentials?.username && credentials?.password) {
+            return {
+                type: 'oauth2',
+                oauth2: {
+                    flow: 'password',
+                    tokenUrl: flows.password.tokenUrl,
+                    username: credentials.username,
+                    password: credentials.password,
+                    clientId: credentials.clientId,
+                    clientSecret: credentials.clientSecret,
+                    scopes: Object.keys(flows.password.scopes || {}),
+                }
+            };
+        }
+        if (flows.clientCredentials && credentials?.clientId && credentials?.clientSecret) {
+            return {
+                type: 'oauth2',
+                oauth2: {
+                    flow: 'clientCredentials',
+                    tokenUrl: flows.clientCredentials.tokenUrl,
+                    clientId: credentials.clientId,
+                    clientSecret: credentials.clientSecret,
+                    scopes: Object.keys(flows.clientCredentials.scopes || {}),
+                }
+            };
+        }
+        if (flows.clientCredentials) {
+            return {
+                type: 'oauth2',
+                oauth2: {
+                    flow: 'clientCredentials',
+                    tokenUrl: flows.clientCredentials.tokenUrl,
+                    clientId: credentials?.clientId || '',
+                    clientSecret: credentials?.clientSecret || '',
+                    scopes: Object.keys(flows.clientCredentials.scopes || {}),
+                }
+            };
+        }
+        if (flows.password) {
+            return {
+                type: 'oauth2',
+                oauth2: {
+                    flow: 'password',
+                    tokenUrl: flows.password.tokenUrl,
+                    username: credentials?.username || '',
+                    password: credentials?.password || '',
+                    clientId: credentials?.clientId,
+                    clientSecret: credentials?.clientSecret,
+                    scopes: Object.keys(flows.password.scopes || {}),
+                }
+            };
+        }
+    }
+    // HTTP Bearer
+    if (scheme.type === 'http') {
+        const httpScheme = scheme;
+        if (httpScheme.scheme === 'bearer') {
+            return {
+                type: 'bearer',
+                token: credentials?.bearerToken || '',
+            };
+        }
+        if (httpScheme.scheme === 'basic') {
+            return {
+                type: 'basic',
+                basic: {
+                    username: credentials?.username || '',
+                    password: credentials?.password || '',
+                }
+            };
+        }
+    }
+    // API Key - Extract name and location from spec, use value from user
+    if (scheme.type === 'apiKey') {
+        const apiKeyScheme = scheme;
+        return {
+            type: 'api-key',
+            apiKey: {
+                name: apiKeyScheme.name,
+                in: apiKeyScheme.in === 'query' ? 'query' : 'header',
+                value: credentials?.apiKey || '',
+            }
+        };
+    }
+    return undefined;
+}
+//# sourceMappingURL=auth-visitor.js.map

package/dist/parsers/visitors/auth-visitor.js.map

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

package/dist/prd/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * PRD Module
+ *
+ * Handles reading, normalizing, and storing Product Requirement Documents.
+ *
+ * @module prd
+ */
+export * from './prd-reader.js';
+export * from './prd-storage.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/prd/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prd/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}

package/dist/prd/index.js

@@ -0,0 +1,10 @@
+/**
+ * PRD Module
+ *
+ * Handles reading, normalizing, and storing Product Requirement Documents.
+ *
+ * @module prd
+ */
+export * from './prd-reader.js';
+export * from './prd-storage.js';
+//# sourceMappingURL=index.js.map

package/dist/prd/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prd/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}

package/dist/prd/prd-reader.d.ts

@@ -0,0 +1,124 @@
+/**
+ * PRD Reader Module
+ *
+ * Reads and structures Product Requirement Documents (PRD) from various formats.
+ * This module handles the mechanical work of reading files - the LLM in the CLI
+ * does the intelligent analysis and normalization.
+ *
+ * Supported formats:
+ * - Markdown (.md)
+ * - Plain text (.txt)
+ * - JSON (.json)
+ * - YAML (.yml, .yaml)
+ * - Gherkin/Feature files (.feature)
+ *
+ * @module prd/prd-reader
+ */
+/**
+ * Supported PRD file formats
+ */
+export type PrdFormat = 'markdown' | 'text' | 'json' | 'yaml' | 'gherkin' | 'unknown';
+/**
+ * Raw PRD content as read from file or input
+ */
+export interface RawPrd {
+    /**
+     * Original content of the PRD
+     */
+    content: string;
+    /**
+     * Detected format of the PRD
+     */
+    format: PrdFormat;
+    /**
+     * Source file path if read from file
+     */
+    sourcePath?: string;
+    /**
+     * File name if read from file
+     */
+    fileName?: string;
+    /**
+     * Metadata extracted from the PRD (if any)
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Sections found in the document (for structured formats)
+     */
+    sections?: PrdSection[];
+}
+/**
+ * A section within a PRD document
+ */
+export interface PrdSection {
+    /**
+     * Section title/heading
+     */
+    title: string;
+    /**
+     * Section content
+     */
+    content: string;
+    /**
+     * Nesting level (1 = top level)
+     */
+    level: number;
+    /**
+     * Child sections
+     */
+    children?: PrdSection[];
+}
+/**
+ * Options for reading PRD
+ */
+export interface ReadPrdOptions {
+    /**
+     * Extract sections from the document
+     */
+    extractSections?: boolean;
+    /**
+     * Maximum file size in bytes (default: 1MB)
+     */
+    maxFileSize?: number;
+}
+/**
+ * Reads a PRD from a file path
+ *
+ * @param filePath - Path to the PRD file
+ * @param options - Reading options
+ * @returns Raw PRD content and metadata
+ *
+ * @example
+ * ```typescript
+ * const prd = await readPrdFromFile('./docs/requirements.md');
+ * console.log(prd.format); // 'markdown'
+ * console.log(prd.content); // File contents
+ * ```
+ */
+export declare function readPrdFromFile(filePath: string, options?: ReadPrdOptions): Promise<RawPrd>;
+/**
+ * Reads a PRD from raw text content
+ *
+ * @param content - Raw PRD content
+ * @param options - Reading options
+ * @returns Raw PRD content and metadata
+ *
+ * @example
+ * ```typescript
+ * const prd = readPrdFromContent(`
+ *   # User Stories
+ *   As a user, I want to login so I can access my account.
+ * `);
+ * console.log(prd.format); // 'markdown'
+ * ```
+ */
+export declare function readPrdFromContent(content: string, options?: ReadPrdOptions): RawPrd;
+/**
+ * Reads multiple PRD files from a directory
+ *
+ * @param dirPath - Path to directory containing PRD files
+ * @param options - Reading options
+ * @returns Array of raw PRD contents
+ */
+export declare function readPrdFromDirectory(dirPath: string, options?: ReadPrdOptions): Promise<RawPrd[]>;
+//# sourceMappingURL=prd-reader.d.ts.map

package/dist/prd/prd-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prd-reader.d.ts","sourceRoot":"","sources":["../../src/prd/prd-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AASH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC,CA4CjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,cAAmB,GAC3B,MAAM,CA0BR;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,MAAM,EAAE,CAAC,CA0BnB"}

package/dist/prd/prd-reader.js

@@ -0,0 +1,308 @@
+/**
+ * PRD Reader Module
+ *
+ * Reads and structures Product Requirement Documents (PRD) from various formats.
+ * This module handles the mechanical work of reading files - the LLM in the CLI
+ * does the intelligent analysis and normalization.
+ *
+ * Supported formats:
+ * - Markdown (.md)
+ * - Plain text (.txt)
+ * - JSON (.json)
+ * - YAML (.yml, .yaml)
+ * - Gherkin/Feature files (.feature)
+ *
+ * @module prd/prd-reader
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as yaml from 'yaml';
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('prd-reader');
+/**
+ * Reads a PRD from a file path
+ *
+ * @param filePath - Path to the PRD file
+ * @param options - Reading options
+ * @returns Raw PRD content and metadata
+ *
+ * @example
+ * ```typescript
+ * const prd = await readPrdFromFile('./docs/requirements.md');
+ * console.log(prd.format); // 'markdown'
+ * console.log(prd.content); // File contents
+ * ```
+ */
+export async function readPrdFromFile(filePath, options = {}) {
+    const { maxFileSize = 1024 * 1024 } = options; // 1MB default
+    log.debug('Reading PRD from file', { filePath });
+    // Check file exists
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`PRD file not found: ${filePath}`);
+    }
+    // Check file size
+    const stats = fs.statSync(filePath);
+    if (stats.size > maxFileSize) {
+        throw new Error(`PRD file too large: ${stats.size} bytes (max: ${maxFileSize})`);
+    }
+    // Read file content
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const ext = path.extname(filePath).toLowerCase();
+    const format = detectFormat(ext, content);
+    log.info('PRD file read successfully', { filePath, format, size: stats.size });
+    const rawPrd = {
+        content,
+        format,
+        sourcePath: filePath,
+        fileName: path.basename(filePath),
+    };
+    // Extract metadata and sections based on format
+    if (format === 'yaml' || format === 'json') {
+        rawPrd.metadata = parseStructuredContent(content, format);
+    }
+    if (options.extractSections && (format === 'markdown' || format === 'text')) {
+        rawPrd.sections = extractMarkdownSections(content);
+    }
+    if (format === 'gherkin') {
+        rawPrd.sections = extractGherkinSections(content);
+    }
+    return rawPrd;
+}
+/**
+ * Reads a PRD from raw text content
+ *
+ * @param content - Raw PRD content
+ * @param options - Reading options
+ * @returns Raw PRD content and metadata
+ *
+ * @example
+ * ```typescript
+ * const prd = readPrdFromContent(`
+ *   # User Stories
+ *   As a user, I want to login so I can access my account.
+ * `);
+ * console.log(prd.format); // 'markdown'
+ * ```
+ */
+export function readPrdFromContent(content, options = {}) {
+    log.debug('Reading PRD from content', { contentLength: content.length });
+    const format = detectFormatFromContent(content);
+    const rawPrd = {
+        content,
+        format,
+    };
+    // Extract metadata and sections based on format
+    if (format === 'yaml' || format === 'json') {
+        rawPrd.metadata = parseStructuredContent(content, format);
+    }
+    if (options.extractSections && (format === 'markdown' || format === 'text')) {
+        rawPrd.sections = extractMarkdownSections(content);
+    }
+    if (format === 'gherkin') {
+        rawPrd.sections = extractGherkinSections(content);
+    }
+    log.info('PRD content processed', { format, contentLength: content.length });
+    return rawPrd;
+}
+/**
+ * Reads multiple PRD files from a directory
+ *
+ * @param dirPath - Path to directory containing PRD files
+ * @param options - Reading options
+ * @returns Array of raw PRD contents
+ */
+export async function readPrdFromDirectory(dirPath, options = {}) {
+    log.debug('Reading PRDs from directory', { dirPath });
+    if (!fs.existsSync(dirPath)) {
+        throw new Error(`PRD directory not found: ${dirPath}`);
+    }
+    const supportedExtensions = ['.md', '.txt', '.json', '.yml', '.yaml', '.feature'];
+    const files = fs.readdirSync(dirPath)
+        .filter(f => supportedExtensions.includes(path.extname(f).toLowerCase()));
+    const prds = [];
+    for (const file of files) {
+        const filePath = path.join(dirPath, file);
+        try {
+            const prd = await readPrdFromFile(filePath, options);
+            prds.push(prd);
+        }
+        catch (error) {
+            log.warn('Failed to read PRD file', { file, error });
+        }
+    }
+    log.info('PRDs read from directory', { dirPath, count: prds.length });
+    return prds;
+}
+/**
+ * Detects PRD format from file extension
+ */
+function detectFormat(extension, content) {
+    switch (extension) {
+        case '.md':
+        case '.markdown':
+            return 'markdown';
+        case '.txt':
+            return 'text';
+        case '.json':
+            return 'json';
+        case '.yml':
+        case '.yaml':
+            return 'yaml';
+        case '.feature':
+            return 'gherkin';
+        default:
+            return detectFormatFromContent(content);
+    }
+}
+/**
+ * Detects PRD format from content analysis
+ */
+function detectFormatFromContent(content) {
+    const trimmed = content.trim();
+    // Check for JSON
+    if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+        try {
+            JSON.parse(trimmed);
+            return 'json';
+        }
+        catch {
+            // Not valid JSON
+        }
+    }
+    // Check for Gherkin
+    if (/^(Feature:|Scenario:|Given |When |Then |And |But )/m.test(trimmed)) {
+        return 'gherkin';
+    }
+    // Check for YAML (has key: value patterns without JSON brackets)
+    if (/^[\w-]+:\s*.+$/m.test(trimmed) && !trimmed.startsWith('{')) {
+        try {
+            yaml.parse(trimmed);
+            return 'yaml';
+        }
+        catch {
+            // Not valid YAML
+        }
+    }
+    // Check for Markdown (has headers or formatting)
+    if (/^#{1,6}\s+.+$/m.test(trimmed) || /\*\*.+\*\*|\[.+\]\(.+\)/.test(trimmed)) {
+        return 'markdown';
+    }
+    // Default to text
+    return 'text';
+}
+/**
+ * Parses structured content (JSON/YAML) and returns metadata
+ */
+function parseStructuredContent(content, format) {
+    try {
+        if (format === 'json') {
+            return JSON.parse(content);
+        }
+        else if (format === 'yaml') {
+            return yaml.parse(content) || {};
+        }
+    }
+    catch (error) {
+        log.warn('Failed to parse structured content', { format, error });
+    }
+    return {};
+}
+/**
+ * Extracts sections from Markdown content
+ */
+function extractMarkdownSections(content) {
+    const sections = [];
+    const lines = content.split('\n');
+    let currentSection = null;
+    let currentContent = [];
+    for (const line of lines) {
+        const headerMatch = line.match(/^(#{1,6})\s+(.+)$/);
+        if (headerMatch) {
+            // Save previous section
+            if (currentSection) {
+                currentSection.content = currentContent.join('\n').trim();
+                sections.push(currentSection);
+            }
+            // Start new section
+            const level = headerMatch[1].length;
+            const title = headerMatch[2].trim();
+            currentSection = { title, content: '', level };
+            currentContent = [];
+        }
+        else {
+            currentContent.push(line);
+        }
+    }
+    // Save last section
+    if (currentSection) {
+        currentSection.content = currentContent.join('\n').trim();
+        sections.push(currentSection);
+    }
+    return sections;
+}
+/**
+ * Extracts sections from Gherkin content
+ */
+function extractGherkinSections(content) {
+    const sections = [];
+    const lines = content.split('\n');
+    let currentFeature = null;
+    let currentScenario = null;
+    let currentContent = [];
+    for (const line of lines) {
+        const trimmedLine = line.trim();
+        if (trimmedLine.startsWith('Feature:')) {
+            // Save previous scenario
+            if (currentScenario) {
+                currentScenario.content = currentContent.join('\n').trim();
+                if (currentFeature) {
+                    currentFeature.children = currentFeature.children || [];
+                    currentFeature.children.push(currentScenario);
+                }
+            }
+            // Save previous feature
+            if (currentFeature) {
+                sections.push(currentFeature);
+            }
+            // Start new feature
+            currentFeature = {
+                title: trimmedLine.replace('Feature:', '').trim(),
+                content: '',
+                level: 1,
+                children: []
+            };
+            currentScenario = null;
+            currentContent = [];
+        }
+        else if (trimmedLine.startsWith('Scenario:') || trimmedLine.startsWith('Scenario Outline:')) {
+            // Save previous scenario
+            if (currentScenario) {
+                currentScenario.content = currentContent.join('\n').trim();
+                if (currentFeature) {
+                    currentFeature.children = currentFeature.children || [];
+                    currentFeature.children.push(currentScenario);
+                }
+            }
+            // Start new scenario
+            const title = trimmedLine.replace('Scenario Outline:', '').replace('Scenario:', '').trim();
+            currentScenario = { title, content: '', level: 2 };
+            currentContent = [];
+        }
+        else {
+            currentContent.push(line);
+        }
+    }
+    // Save last scenario and feature
+    if (currentScenario) {
+        currentScenario.content = currentContent.join('\n').trim();
+        if (currentFeature) {
+            currentFeature.children = currentFeature.children || [];
+            currentFeature.children.push(currentScenario);
+        }
+    }
+    if (currentFeature) {
+        sections.push(currentFeature);
+    }
+    return sections;
+}
+//# sourceMappingURL=prd-reader.js.map

package/dist/prd/prd-reader.js.map

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