@machina.ai/openapi-contract-tester 2.1.0

package/dist/types/test-execution.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Test execution types - runtime behavior and matchers
+ * @module types/test-execution
+ */
+import type { TestCase } from './test-case.js';
+/**
+ * Response matcher for flexible validation
+ * Validates type instead of exact value (e.g., "is a number" vs "is 123")
+ */
+export interface ResponseMatcher {
+    /**
+     * Type of matcher
+     */
+    type: 'type' | 'regex' | 'range' | 'exists';
+    /**
+     * Expected type (for type matcher)
+     */
+    expectedType?: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'null';
+    /**
+     * Regular expression pattern (for regex matcher)
+     */
+    pattern?: string;
+    /**
+     * Minimum value (for range matcher)
+     */
+    min?: number;
+    /**
+     * Maximum value (for range matcher)
+     */
+    max?: number;
+    /**
+     * Whether field must exist (for exists matcher)
+     */
+    required?: boolean;
+}
+/**
+ * State handler callback for test setup/teardown
+ * Allows users to prepare database, mock services, etc.
+ */
+export type StateHandler = (testCase: TestCase) => Promise<void> | void;
+/**
+ * Options for test execution with matchers and state handlers
+ */
+export interface TestExecutionOptions {
+    /**
+     * Use type-based matchers for response validation
+     * @default false
+     */
+    useMatchers?: boolean;
+    /**
+     * Custom matchers per test or globally
+     * Key: test ID or "*" for all tests
+     * Value: Field path to matcher config
+     * @example
+     * {
+     *   "*": {
+     *     "response.body.id": { type: "type", expectedType: "number" },
+     *     "response.body.email": { type: "regex", pattern: "^[^@]+@[^@]+$" }
+     *   }
+     * }
+     */
+    matchers?: Record<string, Record<string, ResponseMatcher>>;
+    /**
+     * Callback executed before each test
+     * Use for database seeding, mock setup, etc.
+     * @example
+     * beforeTest: async (test) => {
+     *   if (test.path.includes('/users')) {
+     *     await database.seed('users');
+     *   }
+     * }
+     */
+    beforeTest?: StateHandler;
+    /**
+     * Callback executed after each test
+     * Use for cleanup, logging, etc.
+     */
+    afterTest?: StateHandler;
+}
+//# sourceMappingURL=test-execution.d.ts.map

package/dist/types/test-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-execution.d.ts","sourceRoot":"","sources":["../../src/types/test-execution.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IAE5C;;OAEG;IACH,YAAY,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IAE7E;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;IAE3D;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,YAAY,CAAC;IAE1B;;;OAGG;IACH,SAAS,CAAC,EAAE,YAAY,CAAC;CAC1B"}

package/dist/types/test-execution.js

@@ -0,0 +1,6 @@
+/**
+ * Test execution types - runtime behavior and matchers
+ * @module types/test-execution
+ */
+export {};
+//# sourceMappingURL=test-execution.js.map

package/dist/types/test-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-execution.js","sourceRoot":"","sources":["../../src/types/test-execution.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/utils/auth-generator.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Authentication Header Generator
+ *
+ * Centralized utility for generating authentication headers based on OpenAPI security schemes.
+ * This is the single source of truth for auth header generation across all test generators.
+ *
+ * @module utils/auth-generator
+ */
+import type { OpenAPIV3 } from 'openapi-types';
+/**
+ * Generates authentication headers based on security schemes
+ *
+ * This function is agnostic and supports multiple auth types:
+ * - Bearer tokens
+ * - API Keys
+ * - Basic Auth
+ * - OAuth2
+ * - OpenID Connect
+ *
+ * @param securitySchemes - Array of security scheme objects from OpenAPI
+ * @returns Headers object with authentication placeholders
+ *
+ * @example
+ * ```typescript
+ * const headers = generateAuthHeaders([{ type: 'http', scheme: 'bearer' }]);
+ * // Returns: { Authorization: 'Bearer {{TOKEN}}' }
+ * ```
+ */
+export declare function generateAuthHeaders(securitySchemes: OpenAPIV3.SecuritySchemeObject[]): Record<string, string>;
+//# sourceMappingURL=auth-generator.d.ts.map

package/dist/utils/auth-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-generator.d.ts","sourceRoot":"","sources":["../../src/utils/auth-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,SAAS,CAAC,oBAAoB,EAAE,GAChD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA6CxB"}

package/dist/utils/auth-generator.js

@@ -0,0 +1,68 @@
+/**
+ * Authentication Header Generator
+ *
+ * Centralized utility for generating authentication headers based on OpenAPI security schemes.
+ * This is the single source of truth for auth header generation across all test generators.
+ *
+ * @module utils/auth-generator
+ */
+/**
+ * Generates authentication headers based on security schemes
+ *
+ * This function is agnostic and supports multiple auth types:
+ * - Bearer tokens
+ * - API Keys
+ * - Basic Auth
+ * - OAuth2
+ * - OpenID Connect
+ *
+ * @param securitySchemes - Array of security scheme objects from OpenAPI
+ * @returns Headers object with authentication placeholders
+ *
+ * @example
+ * ```typescript
+ * const headers = generateAuthHeaders([{ type: 'http', scheme: 'bearer' }]);
+ * // Returns: { Authorization: 'Bearer {{TOKEN}}' }
+ * ```
+ */
+export function generateAuthHeaders(securitySchemes) {
+    const headers = {};
+    // If no security schemes, return empty headers
+    if (!securitySchemes || securitySchemes.length === 0) {
+        return headers;
+    }
+    // Use the first security scheme that generates a recognisable header.
+    // APIs with multiple schemes (e.g. bearer + apiKey) are supported via the
+    // first matching scheme; additional schemes are intentionally ignored because
+    // a single request can only carry one auth credential set.
+    const scheme = securitySchemes[0];
+    switch (scheme.type) {
+        case 'http':
+            if (scheme.scheme === 'bearer') {
+                // Bearer token authentication
+                headers['Authorization'] = 'Bearer {{TOKEN}}';
+            }
+            else if (scheme.scheme === 'basic') {
+                // Basic authentication
+                headers['Authorization'] = 'Basic {{CREDENTIALS}}';
+            }
+            break;
+        case 'apiKey':
+            // API Key authentication
+            if (scheme.in === 'header') {
+                headers[scheme.name] = '{{API_KEY}}';
+            }
+            // If in=query, it will be handled as query param, not header
+            break;
+        case 'oauth2':
+            // OAuth2 - use Bearer token
+            headers['Authorization'] = 'Bearer {{OAUTH_TOKEN}}';
+            break;
+        case 'openIdConnect':
+            // OpenID Connect - also uses Bearer token
+            headers['Authorization'] = 'Bearer {{OIDC_TOKEN}}';
+            break;
+    }
+    return headers;
+}
+//# sourceMappingURL=auth-generator.js.map

package/dist/utils/auth-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-generator.js","sourceRoot":"","sources":["../../src/utils/auth-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,mBAAmB,CACjC,eAAiD;IAEjD,MAAM,OAAO,GAA2B,EAAE,CAAC;IAE3C,+CAA+C;IAC/C,IAAI,CAAC,eAAe,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,sEAAsE;IACtE,0EAA0E;IAC1E,8EAA8E;IAC9E,2DAA2D;IAC3D,MAAM,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;IAElC,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,MAAM;YACT,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC/B,8BAA8B;gBAC9B,OAAO,CAAC,eAAe,CAAC,GAAG,kBAAkB,CAAC;YAChD,CAAC;iBAAM,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;gBACrC,uBAAuB;gBACvB,OAAO,CAAC,eAAe,CAAC,GAAG,uBAAuB,CAAC;YACrD,CAAC;YACD,MAAM;QAER,KAAK,QAAQ;YACX,yBAAyB;YACzB,IAAI,MAAM,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;gBAC3B,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC;YACvC,CAAC;YACD,6DAA6D;YAC7D,MAAM;QAER,KAAK,QAAQ;YACX,4BAA4B;YAC5B,OAAO,CAAC,eAAe,CAAC,GAAG,wBAAwB,CAAC;YACpD,MAAM;QAER,KAAK,eAAe;YAClB,0CAA0C;YAC1C,OAAO,CAAC,eAAe,CAAC,GAAG,uBAAuB,CAAC;YACnD,MAAM;IACV,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/utils/config.d.ts

@@ -0,0 +1,181 @@
+/**
+ * Centralized Configuration Management
+ *
+ * Loads and validates configuration from environment variables
+ * with sensible defaults for production use.
+ *
+ * @module utils/config
+ */
+/**
+ * HTTP Client Configuration
+ */
+export interface HttpConfig {
+    /**
+     * Default timeout for HTTP requests in milliseconds
+     * @default 5000
+     * @env HTTP_TIMEOUT
+     */
+    timeout: number;
+    /**
+     * Maximum number of parallel requests
+     * @default 5
+     * @env MAX_PARALLEL_REQUESTS
+     */
+    maxParallel: number;
+}
+/**
+ * Retry Logic Configuration
+ */
+export interface RetryConfig {
+    /**
+     * Maximum number of retry attempts
+     * @default 3
+     * @env RETRY_MAX_ATTEMPTS
+     */
+    maxAttempts: number;
+    /**
+     * Initial delay in milliseconds before first retry
+     * @default 1000
+     * @env RETRY_INITIAL_DELAY
+     */
+    initialDelay: number;
+    /**
+     * Maximum delay in milliseconds between retries
+     * @default 10000
+     * @env RETRY_MAX_DELAY
+     */
+    maxDelay: number;
+    /**
+     * Backoff multiplier for exponential backoff
+     * @default 2
+     * @env RETRY_BACKOFF_MULTIPLIER
+     */
+    backoffMultiplier: number;
+}
+/**
+ * Circuit Breaker Configuration
+ */
+export interface CircuitBreakerConfig {
+    /**
+     * Number of failures before opening circuit
+     * @default 5
+     * @env CIRCUIT_BREAKER_THRESHOLD
+     */
+    failureThreshold: number;
+    /**
+     * Time in milliseconds to wait before transitioning to HALF_OPEN
+     * @default 60000 (1 minute)
+     * @env CIRCUIT_BREAKER_TIMEOUT
+     */
+    resetTimeout: number;
+    /**
+     * Number of successful calls in HALF_OPEN before closing circuit
+     * @default 2
+     * @env CIRCUIT_BREAKER_SUCCESS_THRESHOLD
+     */
+    successThreshold: number;
+}
+/**
+ * Logging Configuration
+ */
+export interface LogConfig {
+    /**
+     * Log level (debug, info, warn, error)
+     * @default 'info'
+     * @env LOG_LEVEL
+     */
+    level: 'debug' | 'info' | 'warn' | 'error';
+    /**
+     * Directory where logs are stored
+     * @env LOG_DIR or MCP_ROOT/logs or ~/.openapi-contract-tester/logs
+     */
+    logDir: string;
+    /**
+     * Maximum log file size in bytes before rotation
+     * @default 10485760 (10MB)
+     * @env MAX_LOG_FILE_SIZE
+     */
+    maxFileSize: number;
+    /**
+     * Maximum number of rotated log files to keep
+     * @default 5
+     * @env MAX_LOG_FILES
+     */
+    maxFiles: number;
+}
+/**
+ * Test Execution Configuration
+ */
+export interface TestConfig {
+    /**
+     * Maximum number of tests to run in parallel
+     * @default 5
+     * @env MAX_PARALLEL_TESTS
+     */
+    maxParallel: number;
+    /**
+     * Default timeout for test execution in milliseconds
+     * @default 30000 (30 seconds)
+     * @env TEST_TIMEOUT
+     */
+    timeout: number;
+}
+/**
+ * Complete Application Configuration
+ */
+export interface AppConfig {
+    /**
+     * Root directory for all MCP-related files
+     * @env MCP_ROOT
+     */
+    mcpRoot: string;
+    /**
+     * Whether running in MCP mode (STDIO protocol)
+     * @env MCP_MODE
+     */
+    mcpMode: boolean;
+    /**
+     * HTTP client configuration
+     */
+    http: HttpConfig;
+    /**
+     * Retry logic configuration
+     */
+    retry: RetryConfig;
+    /**
+     * Circuit breaker configuration
+     */
+    circuitBreaker: CircuitBreakerConfig;
+    /**
+     * Logging configuration
+     */
+    log: LogConfig;
+    /**
+     * Test execution configuration
+     */
+    test: TestConfig;
+}
+/**
+ * Load configuration from environment variables
+ *
+ * All values have sensible defaults and are overridable via environment variables.
+ *
+ * @returns Complete application configuration
+ *
+ * @example
+ * ```typescript
+ * import { loadConfig } from './utils/config.js';
+ *
+ * const config = loadConfig();
+ * console.log(`HTTP timeout: ${config.http.timeout}ms`);
+ * console.log(`Logs directory: ${config.log.logDir}`);
+ * ```
+ */
+export declare function loadConfig(): AppConfig;
+/**
+ * Global configuration instance
+ *
+ * Loaded once at startup from environment variables.
+ */
+export declare const config: AppConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA4CH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAE3C;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,IAAI,EAAE,UAAU,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,WAAW,CAAC;IAEnB;;OAEG;IACH,cAAc,EAAE,oBAAoB,CAAC;IAErC;;OAEG;IACH,GAAG,EAAE,SAAS,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,UAAU,CAAC;CAClB;AAgDD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,IAAI,SAAS,CAsCtC;AAED;;;;GAIG;AACH,eAAO,MAAM,MAAM,WAAe,CAAC"}

package/dist/utils/config.js

@@ -0,0 +1,141 @@
+/**
+ * Centralized Configuration Management
+ *
+ * Loads and validates configuration from environment variables
+ * with sensible defaults for production use.
+ *
+ * @module utils/config
+ */
+import * as path from 'path';
+/**
+ * Parse environment variable as integer with fallback
+ */
+function parseEnvInt(key, defaultValue) {
+    const value = process.env[key];
+    if (!value)
+        return defaultValue;
+    const parsed = parseInt(value, 10);
+    return isNaN(parsed) ? defaultValue : parsed;
+}
+/**
+ * Parse environment variable as float with fallback.
+ * Correctly handles the value 0 (unlike `parseFloat(x||default)||default`).
+ */
+function parseEnvFloat(key, defaultValue) {
+    const value = process.env[key];
+    if (!value)
+        return defaultValue;
+    const parsed = parseFloat(value);
+    return isNaN(parsed) ? defaultValue : parsed;
+}
+/**
+ * Parse environment variable as boolean with fallback
+ */
+function parseEnvBool(key, defaultValue) {
+    const value = process.env[key];
+    if (!value)
+        return defaultValue;
+    return value.toLowerCase() === 'true' || value === '1';
+}
+/**
+ * Get directory path with home directory expansion
+ */
+function expandPath(pathStr) {
+    return pathStr.replace(/^~/, process.env.HOME || process.env.USERPROFILE || '~');
+}
+/**
+ * Get MCP root directory
+ */
+function getMcpRoot() {
+    if (process.env.MCP_ROOT) {
+        return expandPath(process.env.MCP_ROOT);
+    }
+    const homeDir = process.env.HOME || process.env.USERPROFILE || '.';
+    return path.join(homeDir, '.openapi-contract-tester');
+}
+/**
+ * Get log directory
+ */
+function getLogDirectory(mcpRoot) {
+    // 1. Explicit LOG_DIR
+    if (process.env.LOG_DIR) {
+        return expandPath(process.env.LOG_DIR);
+    }
+    // 2. MCP_ROOT/logs
+    return path.join(mcpRoot, 'logs');
+}
+/**
+ * Parse log level from environment
+ */
+function parseLogLevel(value) {
+    const normalized = value?.toLowerCase();
+    switch (normalized) {
+        case 'debug':
+            return 'debug';
+        case 'info':
+            return 'info';
+        case 'warn':
+        case 'warning':
+            return 'warn';
+        case 'error':
+            return 'error';
+        default:
+            return 'info';
+    }
+}
+/**
+ * Load configuration from environment variables
+ *
+ * All values have sensible defaults and are overridable via environment variables.
+ *
+ * @returns Complete application configuration
+ *
+ * @example
+ * ```typescript
+ * import { loadConfig } from './utils/config.js';
+ *
+ * const config = loadConfig();
+ * console.log(`HTTP timeout: ${config.http.timeout}ms`);
+ * console.log(`Logs directory: ${config.log.logDir}`);
+ * ```
+ */
+export function loadConfig() {
+    const mcpRoot = getMcpRoot();
+    const isMCPMode = parseEnvBool('MCP_MODE', !process.stdin.isTTY);
+    return {
+        mcpRoot,
+        mcpMode: isMCPMode,
+        http: {
+            timeout: parseEnvInt('HTTP_TIMEOUT', 5000),
+            maxParallel: parseEnvInt('MAX_PARALLEL_REQUESTS', 5),
+        },
+        retry: {
+            maxAttempts: parseEnvInt('RETRY_MAX_ATTEMPTS', 3),
+            initialDelay: parseEnvInt('RETRY_INITIAL_DELAY', 1000),
+            maxDelay: parseEnvInt('RETRY_MAX_DELAY', 10000),
+            backoffMultiplier: parseEnvFloat('RETRY_BACKOFF_MULTIPLIER', 2),
+        },
+        circuitBreaker: {
+            failureThreshold: parseEnvInt('CIRCUIT_BREAKER_THRESHOLD', 5),
+            resetTimeout: parseEnvInt('CIRCUIT_BREAKER_TIMEOUT', 60000),
+            successThreshold: parseEnvInt('CIRCUIT_BREAKER_SUCCESS_THRESHOLD', 2),
+        },
+        log: {
+            level: parseLogLevel(process.env.LOG_LEVEL),
+            logDir: getLogDirectory(mcpRoot),
+            maxFileSize: parseEnvInt('MAX_LOG_FILE_SIZE', 10 * 1024 * 1024), // 10MB
+            maxFiles: parseEnvInt('MAX_LOG_FILES', 5),
+        },
+        test: {
+            maxParallel: parseEnvInt('MAX_PARALLEL_TESTS', 5),
+            timeout: parseEnvInt('TEST_TIMEOUT', 30000),
+        },
+    };
+}
+/**
+ * Global configuration instance
+ *
+ * Loaded once at startup from environment variables.
+ */
+export const config = loadConfig();
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

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

package/dist/utils/coverage-calculator.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Coverage Calculator
+ *
+ * Calculates endpoint coverage from test results
+ * without generating new tests (unlike preview-test-coverage)
+ *
+ * @module utils/coverage-calculator
+ */
+interface TestResult {
+    method?: string;
+    path?: string;
+    endpoint?: string;
+    status: string;
+}
+interface CoverageResult {
+    totalEndpoints: number;
+    testedEndpoints: number;
+    coveragePercentage: string;
+    uncoveredEndpoints: Array<{
+        method: string;
+        path: string;
+    }>;
+    endpointDetails: Array<{
+        endpoint: string;
+        method: string;
+        path: string;
+        totalTests: number;
+        passedTests: number;
+        failedTests: number;
+        hasCoverage: boolean;
+    }>;
+}
+/**
+ * Calculates endpoint coverage from test results
+ *
+ * Analyzes results.json to determine which endpoints were tested
+ * and which are missing coverage
+ *
+ * @param results - Test results object with allTests array
+ * @returns Coverage statistics
+ *
+ * @example
+ * ```typescript
+ * const results = JSON.parse(await fs.readFile('results.json', 'utf-8'));
+ * const coverage = calculateCoverageFromResults(results);
+ *
+ * console.log(coverage.coveragePercentage); // "85%"
+ * console.log(coverage.uncoveredEndpoints); // [{ method: "DELETE", path: "/users/{id}" }]
+ * ```
+ */
+export declare function calculateCoverageFromResults(results: {
+    allTests: TestResult[];
+}): CoverageResult;
+/**
+ * Calculates coverage with OpenAPI spec to find truly uncovered endpoints
+ *
+ * Compares test results against OpenAPI spec to identify endpoints
+ * that exist in spec but have no tests
+ *
+ * @param results - Test results object
+ * @param specEndpoints - Parsed endpoints from OpenAPI spec
+ * @returns Coverage statistics including truly uncovered endpoints
+ *
+ * @example
+ * ```typescript
+ * const spec = await parseOpenAPISpec('api.yml');
+ * const endpoints = extractEndpoints(spec);
+ * const coverage = calculateCoverageWithSpec(results, endpoints);
+ *
+ * console.log(coverage.uncoveredEndpoints);
+ * // [{ method: "DELETE", path: "/admin/logs" }]
+ * ```
+ */
+export declare function calculateCoverageWithSpec(results: {
+    allTests: TestResult[];
+}, specEndpoints: Array<{
+    method: string;
+    path: string;
+}>): CoverageResult;
+export {};
+//# sourceMappingURL=coverage-calculator.d.ts.map

package/dist/utils/coverage-calculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage-calculator.d.ts","sourceRoot":"","sources":["../../src/utils/coverage-calculator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,UAAU,UAAU;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,cAAc;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,eAAe,EAAE,KAAK,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,OAAO,CAAC;KACtB,CAAC,CAAC;CACJ;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE;IACpD,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB,GAAG,cAAc,CAwEjB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE;IAAE,QAAQ,EAAE,UAAU,EAAE,CAAA;CAAE,EACnC,aAAa,EAAE,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GACrD,cAAc,CAsChB"}