@machina.ai/openapi-contract-tester 2.1.0

package/dist/generators/happy-path-generator.js

@@ -0,0 +1,275 @@
+/**
+ * Happy Path Test Case Generator
+ *
+ * Generates valid test cases for all endpoints in an OpenAPI specification.
+ * These tests represent the "happy path" - normal, successful scenarios with valid data.
+ *
+ * @module generators/happy-path-generator
+ */
+import { faker } from '@faker-js/faker';
+import { generateDataFromSchema, aiLevelToMode } from './data-generator.js';
+import { generateAuthHeaders } from '../utils/auth-generator.js';
+/**
+ * Generates happy path test cases for all endpoints in an OpenAPI specification
+ *
+ * @param endpoints - Array of parsed endpoints from OpenAPI spec
+ * @param options - Generation options
+ * @returns Array of happy path test cases
+ *
+ * @example
+ * ```typescript
+ * const spec = await parseOpenAPISpec('./api.yml');
+ * const endpoints = extractEndpoints(spec);
+ * const tests = generateHappyPathTests(endpoints);
+ * console.log(`Generated ${tests.length} happy path tests`);
+ * ```
+ */
+export async function generateHappyPathTests(endpoints, options = {}) {
+    const { seed } = options;
+    // Set seed for reproducibility if provided
+    if (seed !== undefined) {
+        faker.seed(seed);
+    }
+    const testCases = [];
+    for (const endpoint of endpoints) {
+        const testCase = await generateHappyPathTest(endpoint, options);
+        if (testCase) {
+            testCases.push(testCase);
+        }
+    }
+    return testCases;
+}
+/**
+ * Generates a single happy path test case for an endpoint
+ *
+ * @param endpoint - Parsed endpoint information
+ * @param options - Generation options (for real data)
+ * @returns Happy path test case, or undefined if cannot generate
+ * @internal
+ */
+async function generateHappyPathTest(endpoint, options = {}) {
+    const { method, path, pathParams, queryParams, requestBody, responses } = endpoint;
+    const { realData, useExamples = true, includeOptional = true, aiLevel, aiMode, apiContext } = options;
+    // Determine expected success status code
+    const expectedStatus = getSuccessStatusCode(method, responses);
+    if (!expectedStatus) {
+        // Cannot determine success status, skip this endpoint
+        return undefined;
+    }
+    // Generate path parameters
+    const pathParamsData = {};
+    for (const param of pathParams) {
+        pathParamsData[param.name] = generatePathParamValue(param);
+    }
+    // Generate query parameters (only required ones for happy path)
+    const queryParamsData = {};
+    for (const param of queryParams) {
+        if (param.required) {
+            queryParamsData[param.name] = generateQueryParamValue(param);
+        }
+    }
+    // Determine effective AI mode based on aiLevel
+    const effectiveAiMode = aiLevelToMode(aiLevel, aiMode);
+    // Generate request body with REAL DATA for happy paths
+    const bodyData = requestBody
+        ? await generateDataFromSchema(requestBody, {
+            includeOptional,
+            realData, // ← CRITICAL: Use real credentials/data
+            useExamples, // ← Use schema examples
+            aiMode: effectiveAiMode,
+            apiContext
+        })
+        : undefined;
+    // Generate authentication headers if endpoint requires auth
+    const authHeaders = generateAuthHeaders(endpoint.securitySchemes || []);
+    // Get expected response schema
+    const expectedSchema = responses[expectedStatus];
+    // Generate test case ID and name
+    const testId = `happy-${method.toLowerCase()}-${path.replace(/[^a-zA-Z0-9]/g, '-')}`;
+    const testName = `${method} ${path} - Happy Path`;
+    return {
+        id: testId,
+        name: testName,
+        description: `Valid request to ${method} ${path} with all required fields`,
+        category: 'happy-path',
+        method,
+        path,
+        pathParams: pathParamsData,
+        queryParams: queryParamsData,
+        headers: authHeaders, // ← NUEVO: Include auth headers
+        body: bodyData,
+        contentType: endpoint.requestContentType, // AGNOSTIC: From OpenAPI spec (json, form-urlencoded, etc.)
+        expectedStatus,
+        expectedSchema,
+        validateSchema: true,
+        requiresAuth: endpoint.requiresAuth, // AGNOSTIC: From OpenAPI spec
+    };
+}
+/**
+ * Determines the expected success status code for an HTTP method
+ *
+ * @param method - HTTP method
+ * @param responses - Response schemas by status code
+ * @returns Success status code, or undefined if none found
+ * @internal
+ */
+function getSuccessStatusCode(method, responses) {
+    // Priority order for success codes based on method
+    const successCodesByMethod = {
+        GET: [200],
+        POST: [201, 200],
+        PUT: [200, 204],
+        PATCH: [200, 204],
+        DELETE: [204, 200],
+        HEAD: [200],
+        OPTIONS: [200],
+    };
+    const priorityCodes = successCodesByMethod[method] || [200];
+    // Try to find a success code in priority order
+    for (const code of priorityCodes) {
+        if (responses[code]) {
+            return code;
+        }
+    }
+    // If no priority code found, look for any 2xx code
+    const availableCodes = Object.keys(responses).map(Number);
+    const successCode = availableCodes.find(code => code >= 200 && code < 300);
+    return successCode;
+}
+/**
+ * Generates a valid value for a path parameter
+ *
+ * @param param - Path parameter definition
+ * @returns Generated parameter value
+ * @internal
+ */
+function generatePathParamValue(param) {
+    if (!param.schema || '$ref' in param.schema) {
+        // Fallback: generate a reasonable default
+        return faker.string.uuid();
+    }
+    const schema = param.schema;
+    // Generate based on schema type and format
+    if (schema.type === 'integer') {
+        return schema.minimum ?? 1;
+    }
+    if (schema.type === 'number') {
+        return schema.minimum ?? 1.0;
+    }
+    if (schema.type === 'string') {
+        if (schema.format === 'uuid') {
+            return faker.string.uuid();
+        }
+        if (schema.enum && schema.enum.length > 0) {
+            return schema.enum[0];
+        }
+        if (schema.pattern) {
+            // For patterns, generate a simple valid value
+            return faker.string.alphanumeric(10);
+        }
+        // Default string
+        return faker.string.alphanumeric(10);
+    }
+    // Fallback
+    return faker.string.uuid();
+}
+/**
+ * Generates a valid value for a query parameter
+ *
+ * @param param - Query parameter definition
+ * @returns Generated parameter value
+ * @internal
+ */
+function generateQueryParamValue(param) {
+    if (!param.schema || '$ref' in param.schema) {
+        // Fallback: generate a reasonable default
+        return 'value';
+    }
+    const schema = param.schema;
+    // Use default if available
+    if (schema.default !== undefined) {
+        return schema.default;
+    }
+    // Generate based on schema type
+    if (schema.type === 'boolean') {
+        return true;
+    }
+    if (schema.type === 'integer') {
+        const min = schema.minimum ?? 1;
+        const max = schema.maximum ?? 100;
+        return Math.floor((min + max) / 2);
+    }
+    if (schema.type === 'number') {
+        const min = schema.minimum ?? 1;
+        const max = schema.maximum ?? 100;
+        return (min + max) / 2;
+    }
+    if (schema.type === 'string') {
+        if (schema.enum && schema.enum.length > 0) {
+            return schema.enum[0];
+        }
+        return faker.lorem.word();
+    }
+    // Fallback
+    return 'value';
+}
+/**
+ * Generates happy path test cases for a specific endpoint path
+ *
+ * Useful when you want to generate tests for only certain endpoints.
+ *
+ * @param endpoints - Array of parsed endpoints
+ * @param pathFilter - Path pattern to filter (e.g., '/users', '/users/{id}')
+ * @param options - Generation options
+ * @returns Array of happy path test cases for matching endpoints
+ *
+ * @example
+ * ```typescript
+ * const spec = await parseOpenAPISpec('./api.yml');
+ * const endpoints = extractEndpoints(spec);
+ * const userTests = generateHappyPathTestsForPath(endpoints, '/users');
+ * ```
+ */
+export async function generateHappyPathTestsForPath(endpoints, pathFilter, options = {}) {
+    const filteredEndpoints = endpoints.filter(e => e.path === pathFilter);
+    return await generateHappyPathTests(filteredEndpoints, options);
+}
+/**
+ * Generates happy path test cases for a specific HTTP method
+ *
+ * @param endpoints - Array of parsed endpoints
+ * @param methodFilter - HTTP method to filter (e.g., 'GET', 'POST')
+ * @param options - Generation options
+ * @returns Array of happy path test cases for matching method
+ *
+ * @example
+ * ```typescript
+ * const spec = await parseOpenAPISpec('./api.yml');
+ * const endpoints = extractEndpoints(spec);
+ * const postTests = generateHappyPathTestsForMethod(endpoints, 'POST');
+ * ```
+ */
+export async function generateHappyPathTestsForMethod(endpoints, methodFilter, options = {}) {
+    const filteredEndpoints = endpoints.filter(e => e.method === methodFilter);
+    return await generateHappyPathTests(filteredEndpoints, options);
+}
+/**
+ * Generates happy path test cases for endpoints with a specific tag
+ *
+ * @param endpoints - Array of parsed endpoints
+ * @param tag - OpenAPI tag to filter by
+ * @param options - Generation options
+ * @returns Array of happy path test cases for matching tag
+ *
+ * @example
+ * ```typescript
+ * const spec = await parseOpenAPISpec('./api.yml');
+ * const endpoints = extractEndpoints(spec);
+ * const userTests = generateHappyPathTestsForTag(endpoints, 'users');
+ * ```
+ */
+export async function generateHappyPathTestsForTag(endpoints, tag, options = {}) {
+    const filteredEndpoints = endpoints.filter(e => e.operation.tags?.includes(tag));
+    return await generateHappyPathTests(filteredEndpoints, options);
+}
+//# sourceMappingURL=happy-path-generator.js.map

package/dist/generators/happy-path-generator.js.map

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

package/dist/generators/test-enricher.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Test Enricher - Post-processing for test metadata
+ *
+ * Enriches generated tests with technical metadata from OpenAPI endpoints.
+ * This is the SINGLE SOURCE OF TRUTH for headers, contentType, and auth requirements.
+ *
+ * @module generators/test-enricher
+ */
+import type { TestCase, ParsedEndpoint } from '../types/index.js';
+import { generateAuthHeaders } from '../utils/auth-generator.js';
+/**
+ * Enriches tests with metadata from their corresponding endpoints
+ *
+ * This function ensures ALL tests (heuristic or LLM-generated) have complete
+ * technical metadata inferred from the OpenAPI specification.
+ *
+ * @param tests - Array of tests to enrich
+ * @param endpoints - Array of parsed endpoints from OpenAPI spec
+ * @returns Enriched tests with complete metadata
+ *
+ * @example
+ * ```typescript
+ * const tests = [...heuristicTests, ...llmTests];
+ * const enrichedTests = enrichTestsWithMetadata(tests, endpoints);
+ * // All tests now have headers, contentType, requiresAuth, etc.
+ * ```
+ */
+export declare function enrichTestsWithMetadata(tests: TestCase[], endpoints: ParsedEndpoint[]): TestCase[];
+export { generateAuthHeaders };
+/**
+ * Validates that a test has all required metadata
+ *
+ * @param test - Test case to validate
+ * @returns True if test has all required metadata
+ */
+export declare function validateTestMetadata(test: TestCase): boolean;
+/**
+ * Filters tests that have valid metadata
+ *
+ * @param tests - Array of tests to filter
+ * @returns Only tests with valid metadata
+ */
+export declare function filterValidTests(tests: TestCase[]): TestCase[];
+//# sourceMappingURL=test-enricher.d.ts.map

package/dist/generators/test-enricher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-enricher.d.ts","sourceRoot":"","sources":["../../src/generators/test-enricher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAElE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAIjE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,QAAQ,EAAE,EACjB,SAAS,EAAE,cAAc,EAAE,GAC1B,QAAQ,EAAE,CAsDZ;AAGD,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAa5D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAY9D"}

package/dist/generators/test-enricher.js

@@ -0,0 +1,109 @@
+/**
+ * Test Enricher - Post-processing for test metadata
+ *
+ * Enriches generated tests with technical metadata from OpenAPI endpoints.
+ * This is the SINGLE SOURCE OF TRUTH for headers, contentType, and auth requirements.
+ *
+ * @module generators/test-enricher
+ */
+import { createLogger } from '../utils/logger.js';
+import { generateAuthHeaders } from '../utils/auth-generator.js';
+const log = createLogger('test-enricher');
+/**
+ * Enriches tests with metadata from their corresponding endpoints
+ *
+ * This function ensures ALL tests (heuristic or LLM-generated) have complete
+ * technical metadata inferred from the OpenAPI specification.
+ *
+ * @param tests - Array of tests to enrich
+ * @param endpoints - Array of parsed endpoints from OpenAPI spec
+ * @returns Enriched tests with complete metadata
+ *
+ * @example
+ * ```typescript
+ * const tests = [...heuristicTests, ...llmTests];
+ * const enrichedTests = enrichTestsWithMetadata(tests, endpoints);
+ * // All tests now have headers, contentType, requiresAuth, etc.
+ * ```
+ */
+export function enrichTestsWithMetadata(tests, endpoints) {
+    log.info('Enriching tests with endpoint metadata', {
+        testCount: tests.length,
+        endpointCount: endpoints.length
+    });
+    const enriched = tests.map(test => {
+        // Find corresponding endpoint
+        const endpoint = endpoints.find(e => e.method === test.method && e.path === test.path);
+        if (!endpoint) {
+            log.warn('Endpoint not found for test', {
+                testId: test.id,
+                method: test.method,
+                path: test.path
+            });
+            return test; // Return as-is if endpoint not found
+        }
+        // Enrich with endpoint metadata
+        const enrichedTest = {
+            ...test,
+            // Headers: use test's headers if present, otherwise infer from endpoint
+            headers: (test.headers && Object.keys(test.headers).length > 0)
+                ? test.headers
+                : generateAuthHeaders(endpoint.securitySchemes || []),
+            // Content-Type: from endpoint if not specified
+            contentType: test.contentType || endpoint.requestContentType,
+            // Auth requirement: from endpoint
+            requiresAuth: endpoint.requiresAuth
+        };
+        log.debug('Test enriched', {
+            testId: test.id,
+            hadHeaders: !!(test.headers && Object.keys(test.headers).length > 0),
+            enrichedHeaders: Object.keys(enrichedTest.headers || {}).length,
+            contentType: enrichedTest.contentType,
+            requiresAuth: enrichedTest.requiresAuth
+        });
+        return enrichedTest;
+    });
+    log.info('Tests enrichment completed', {
+        enrichedCount: enriched.length,
+        withHeaders: enriched.filter(t => t.headers && Object.keys(t.headers).length > 0).length
+    });
+    return enriched;
+}
+// Re-export generateAuthHeaders for backward compatibility
+export { generateAuthHeaders };
+/**
+ * Validates that a test has all required metadata
+ *
+ * @param test - Test case to validate
+ * @returns True if test has all required metadata
+ */
+export function validateTestMetadata(test) {
+    // Check if test has basic required fields
+    if (!test.method || !test.path || !test.expectedStatus) {
+        return false;
+    }
+    // If endpoint requires auth, test should have headers
+    if (test.requiresAuth && (!test.headers || Object.keys(test.headers).length === 0)) {
+        log.warn('Test requires auth but has no headers', { testId: test.id });
+        return false;
+    }
+    return true;
+}
+/**
+ * Filters tests that have valid metadata
+ *
+ * @param tests - Array of tests to filter
+ * @returns Only tests with valid metadata
+ */
+export function filterValidTests(tests) {
+    const valid = tests.filter(validateTestMetadata);
+    if (valid.length < tests.length) {
+        log.warn('Some tests filtered out due to invalid metadata', {
+            total: tests.length,
+            valid: valid.length,
+            filtered: tests.length - valid.length
+        });
+    }
+    return valid;
+}
+//# sourceMappingURL=test-enricher.js.map

package/dist/generators/test-enricher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-enricher.js","sourceRoot":"","sources":["../../src/generators/test-enricher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,GAAG,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;AAE1C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAAiB,EACjB,SAA2B;IAE3B,GAAG,CAAC,IAAI,CAAC,wCAAwC,EAAE;QACjD,SAAS,EAAE,KAAK,CAAC,MAAM;QACvB,aAAa,EAAE,SAAS,CAAC,MAAM;KAChC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QAChC,8BAA8B;QAC9B,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAClC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CACjD,CAAC;QAEF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,GAAG,CAAC,IAAI,CAAC,6BAA6B,EAAE;gBACtC,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,IAAI,EAAE,IAAI,CAAC,IAAI;aAChB,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,CAAC,qCAAqC;QACpD,CAAC;QAED,gCAAgC;QAChC,MAAM,YAAY,GAAa;YAC7B,GAAG,IAAI;YAEP,wEAAwE;YACxE,OAAO,EAAE,CAAC,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;gBAC7D,CAAC,CAAC,IAAI,CAAC,OAAO;gBACd,CAAC,CAAC,mBAAmB,CAAC,QAAQ,CAAC,eAAe,IAAI,EAAE,CAAC;YAEvD,+CAA+C;YAC/C,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,QAAQ,CAAC,kBAAkB;YAE5D,kCAAkC;YAClC,YAAY,EAAE,QAAQ,CAAC,YAAY;SACpC,CAAC;QAEF,GAAG,CAAC,KAAK,CAAC,eAAe,EAAE;YACzB,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;YACpE,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM;YAC/D,WAAW,EAAE,YAAY,CAAC,WAAW;YACrC,YAAY,EAAE,YAAY,CAAC,YAAY;SACxC,CAAC,CAAC;QAEH,OAAO,YAAY,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,4BAA4B,EAAE;QACrC,aAAa,EAAE,QAAQ,CAAC,MAAM;QAC9B,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM;KACzF,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,2DAA2D;AAC3D,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAc;IACjD,0CAA0C;IAC1C,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;QACvD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,sDAAsD;IACtD,IAAI,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QACnF,GAAG,CAAC,IAAI,CAAC,uCAAuC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACvE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAiB;IAChD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAEjD,IAAI,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QAChC,GAAG,CAAC,IAAI,CAAC,iDAAiD,EAAE;YAC1D,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,QAAQ,EAAE,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM;SACtC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * OpenAPI Contract Tester MCP Server
+ * Entry point for the Model Context Protocol server
+ *
+ * @module index
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG"}

package/dist/index.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * OpenAPI Contract Tester MCP Server
+ * Entry point for the Model Context Protocol server
+ *
+ * @module index
+ */
+import { startMCPServer } from './mcp/server.js';
+// Start the MCP server
+startMCPServer().catch((error) => {
+    console.error('Fatal error starting MCP server:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,uBAAuB;AACvB,cAAc,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC/B,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;IACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/llm/ai-cache.d.ts

@@ -0,0 +1,123 @@
+/**
+ * AI Response Cache
+ *
+ * Caches LLM responses to reduce API calls, costs, and latency.
+ * Uses simple in-memory cache with TTL (time-to-live).
+ *
+ * @module llm/ai-cache
+ */
+/**
+ * Cache statistics
+ */
+interface CacheStats {
+    hits: number;
+    misses: number;
+    size: number;
+    hitRate: number;
+}
+/**
+ * AI Response Cache
+ *
+ * Simple in-memory cache for LLM responses.
+ * Automatically expires entries after TTL.
+ */
+declare class AICache {
+    private cache;
+    private readonly TTL;
+    private hits;
+    private misses;
+    /**
+     * Creates a new AI cache
+     *
+     * @param ttl - Time-to-live in milliseconds (default: 1 hour)
+     */
+    constructor(ttl?: number);
+    /**
+     * Generates a hash key for a prompt
+     *
+     * @param prompt - Prompt text
+     * @returns Hash key
+     */
+    private getHash;
+    /**
+     * Gets cached response for a prompt
+     *
+     * @param prompt - Prompt text
+     * @returns Cached response or null if not found/expired
+     */
+    get(prompt: string): string | null;
+    /**
+     * Stores a response in the cache
+     *
+     * @param prompt - Prompt text
+     * @param response - LLM response
+     */
+    set(prompt: string, response: string): void;
+    /**
+     * Clears the entire cache
+     */
+    clear(): void;
+    /**
+     * Removes expired entries from the cache
+     */
+    private cleanup;
+    /**
+     * Gets cache statistics
+     *
+     * @returns Cache statistics
+     */
+    getStats(): CacheStats;
+    /**
+     * Logs cache statistics
+     */
+    logStats(): void;
+    /**
+     * Checks if cache contains a prompt
+     *
+     * @param prompt - Prompt text
+     * @returns true if cached and not expired
+     */
+    has(prompt: string): boolean;
+    /**
+     * Gets the number of entries in the cache
+     *
+     * @returns Cache size
+     */
+    size(): number;
+    /**
+     * Removes a specific entry from the cache
+     *
+     * @param prompt - Prompt text
+     * @returns true if entry was removed
+     */
+    delete(prompt: string): boolean;
+    /**
+     * Gets all cached prompts (for debugging)
+     *
+     * @returns Array of cached prompt hashes and timestamps
+     */
+    getCachedPrompts(): Array<{
+        hash: string;
+        age: number;
+        hits: number;
+    }>;
+}
+/**
+ * Global AI cache instance (1 hour TTL)
+ */
+export declare const aiCache: AICache;
+/**
+ * Gets the global AI cache instance
+ *
+ * @returns AI cache instance
+ */
+export declare function getAICache(): AICache;
+/**
+ * Creates a new AI cache with custom TTL
+ *
+ * @param ttl - Time-to-live in milliseconds
+ * @returns New AI cache instance
+ */
+export declare function createAICache(ttl: number): AICache;
+export {};
+//# sourceMappingURL=ai-cache.d.ts.map

package/dist/llm/ai-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-cache.d.ts","sourceRoot":"","sources":["../../src/llm/ai-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiBH;;GAEG;AACH,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,cAAM,OAAO;IACX,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;IAEnB;;;;OAIG;gBACS,GAAG,GAAE,MAAgB;IAQjC;;;;;OAKG;IACH,OAAO,CAAC,OAAO;IAIf;;;;;OAKG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAgClC;;;;;OAKG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAmB3C;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,OAAO,CAAC,OAAO;IAqBf;;;;OAIG;IACH,QAAQ,IAAI,UAAU;IAYtB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAQhB;;;;;OAKG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI5B;;;;OAIG;IACH,IAAI,IAAI,MAAM;IAId;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAY/B;;;;OAIG;IACH,gBAAgB,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAQvE;AAED;;GAEG;AACH,eAAO,MAAM,OAAO,SAAuB,CAAC;AAE5C;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAElD"}