api-tests-coverage 1.0.20 → 1.0.21

package/dist/src/generation/ai-flow-exporter.d.ts

@@ -1,7 +0,0 @@
-/**
- * Feature 28 — AiFlowExporter
- * Produces ai-ready-flows.md and ai-ready-flows.json for AI coding assistants.
- */
-import type { AiReadyFlows, AiFlowExporterOptions } from './types';
-export declare function exportAiFlows(opts: AiFlowExporterOptions): Promise<AiReadyFlows>;
-//# sourceMappingURL=ai-flow-exporter.d.ts.map

package/dist/src/generation/ai-flow-exporter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ai-flow-exporter.d.ts","sourceRoot":"","sources":["../../../src/generation/ai-flow-exporter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EACV,YAAY,EAEZ,qBAAqB,EAGtB,MAAM,SAAS,CAAC;AAyJjB,wBAAsB,aAAa,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC,CAsGtF"}

package/dist/src/generation/ai-flow-exporter.js

@@ -1,260 +0,0 @@
-"use strict";
-/**
- * Feature 28 — AiFlowExporter
- * Produces ai-ready-flows.md and ai-ready-flows.json for AI coding assistants.
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.exportAiFlows = exportAiFlows;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const gap_extractor_1 = require("./gap-extractor");
-const context_builder_1 = require("./context-builder");
-const template_renderer_1 = require("./template-renderer");
-const file_router_1 = require("./file-router");
-// ─── Priority filter ──────────────────────────────────────────────────────────
-const PRIORITY_VALUES = {
-    P0: 0, P1: 1, P2: 2, P3: 3, P4: 4, P5: 5,
-};
-function priorityGte(a, b) {
-    return PRIORITY_VALUES[a] <= PRIORITY_VALUES[b];
-}
-// ─── Copilot prompt builder ───────────────────────────────────────────────────
-function buildCopilotPrompt(gap, projectName, testFramework, appImportPath) {
-    var _a;
-    const lines = [
-        `Generate a ${testFramework} test file at \`${gap.suggestedOutputPath}\` for ${gap.endpoint.method} ${gap.endpoint.path}.`,
-        `Import the app: \`import { app } from '${appImportPath}'\`.`,
-        `Test cases to cover:`,
-    ];
-    for (const tc of gap.missingTestCases) {
-        lines.push(`- ${tc.description} (expect HTTP ${tc.expectedStatus})`);
-    }
-    if (gap.endpoint.auth.required) {
-        lines.push(`Auth: Required (${(_a = gap.endpoint.auth.scheme) !== null && _a !== void 0 ? _a : 'Bearer'} token). Use POST /api/users/login to get a token.`);
-    }
-    if (gap.existingSimilarTests.length > 0) {
-        lines.push(`Follow the pattern in \`${gap.existingSimilarTests[0]}\` for style guidance.`);
-    }
-    lines.push(`Rules: assert status code BEFORE body; no toBeTruthy(); use specific matchers.`);
-    const prompt = lines.join(' ');
-    // Truncate to ~800 tokens (~3200 chars as rough estimate)
-    return prompt.length > 3200 ? prompt.slice(0, 3197) + '...' : prompt;
-}
-// ─── Missing test case builder ────────────────────────────────────────────────
-function buildMissingTestCases(gap) {
-    var _a, _b, _c, _d, _e, _f;
-    const cases = [];
-    const successStatus = (_c = (_b = (_a = gap.responses) === null || _a === void 0 ? void 0 : _a.find(r => r.statusCode >= 200 && r.statusCode < 300)) === null || _b === void 0 ? void 0 : _b.statusCode) !== null && _c !== void 0 ? _c : 200;
-    cases.push({ id: 'happy-path', description: 'valid request succeeds', expectedStatus: successStatus });
-    if (gap.endpoint.auth.required) {
-        cases.push({ id: 'no-auth', description: 'missing auth token', expectedStatus: 401 });
-        cases.push({ id: 'invalid-auth', description: 'invalid token', expectedStatus: 401 });
-    }
-    if (gap.endpoint.auth.optional) {
-        cases.push({ id: 'no-auth-optional', description: 'request without auth (optional)', expectedStatus: successStatus });
-    }
-    const errorResponses = (_e = (_d = gap.responses) === null || _d === void 0 ? void 0 : _d.filter(r => r.statusCode >= 400)) !== null && _e !== void 0 ? _e : [];
-    for (const resp of errorResponses.slice(0, 3)) {
-        cases.push({
-            id: `error-${resp.statusCode}`,
-            description: (_f = resp.description) !== null && _f !== void 0 ? _f : `error ${resp.statusCode}`,
-            expectedStatus: resp.statusCode,
-        });
-    }
-    return cases;
-}
-// ─── Markdown generator ───────────────────────────────────────────────────────
-function buildMarkdown(flows) {
-    var _a, _b;
-    const lines = [
-        `# AI-Ready Test Generation Context`,
-        `> Generated by api-test-coverage-analyzer | Project: ${flows.project.name} | Analyzed: ${flows.generatedAt.split('T')[0]}`,
-        ``,
-        `## How to Use This Document`,
-        `This document contains structured context for an AI assistant to generate missing tests.`,
-        `For each gap section below, instruct your AI: "Generate tests for this gap using the context provided."`,
-        ``,
-        `---`,
-        ``,
-    ];
-    for (let i = 0; i < flows.gaps.length; i++) {
-        const gap = flows.gaps[i];
-        lines.push(`## Gap ${i + 1}: ${gap.endpoint.method} ${gap.endpoint.path} — [PRIORITY: ${gap.priority} | RISK: ${gap.riskScore}]`);
-        lines.push(``);
-        lines.push(`### What Needs Testing`);
-        lines.push(`Endpoint \`${gap.endpoint.method} ${gap.endpoint.path}\` is missing test coverage. Tests needed for:`);
-        for (const tc of gap.missingTestCases) {
-            lines.push(`- ${tc.description} (expect ${tc.expectedStatus})`);
-        }
-        lines.push(``);
-        lines.push(`### Endpoint Contract`);
-        lines.push(`- **Method:** ${gap.endpoint.method}`);
-        lines.push(`- **Path:** \`${gap.endpoint.path}\``);
-        if (gap.endpoint.auth.required) {
-            lines.push(`- **Auth:** Required (${(_a = gap.endpoint.auth.type) !== null && _a !== void 0 ? _a : 'JWT'} ${(_b = gap.endpoint.auth.scheme) !== null && _b !== void 0 ? _b : 'Bearer'} token)`);
-        }
-        else {
-            lines.push(`- **Auth:** Not required`);
-        }
-        lines.push(``);
-        lines.push(`### Project Context`);
-        lines.push(`- **Language:** ${flows.project.language}`);
-        lines.push(`- **Test Framework:** ${flows.project.testFramework}`);
-        lines.push(`- **App Import:** \`import { app } from '${flows.project.appImportPath}'\``);
-        if (gap.existingSimilarTests.length > 0) {
-            lines.push(`- **Existing Similar Tests:** See \`${gap.existingSimilarTests[0]}\` for patterns`);
-        }
-        lines.push(``);
-        lines.push(`### Copilot Instructions`);
-        lines.push(gap.copilotPrompt);
-        if (gap.generatedCode) {
-            lines.push(``);
-            lines.push(`### Generated Scaffold`);
-            lines.push(`\`\`\`typescript`);
-            lines.push(gap.generatedCode);
-            lines.push(`\`\`\``);
-        }
-        lines.push(``);
-        lines.push(`---`);
-        lines.push(``);
-    }
-    return lines.join('\n');
-}
-// ─── Similar test finder ──────────────────────────────────────────────────────
-function findSimilarTests(apiPath) {
-    const testsDir = path.join(process.cwd(), 'tests');
-    if (!fs.existsSync(testsDir))
-        return [];
-    try {
-        const files = fs.readdirSync(testsDir).filter(f => f.endsWith('.test.ts') || f.endsWith('.test.js'));
-        // Return up to 2 similar test files
-        return files.slice(0, 2).map(f => `tests/${f}`);
-    }
-    catch {
-        return [];
-    }
-}
-// ─── Public API ───────────────────────────────────────────────────────────────
-async function exportAiFlows(opts) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
-    const format = (_a = opts.format) !== null && _a !== void 0 ? _a : 'both';
-    const maxGaps = (_b = opts.maxGaps) !== null && _b !== void 0 ? _b : 50;
-    const minPriority = (_c = opts.priority) !== null && _c !== void 0 ? _c : 'P3';
-    // Load discovery info
-    const summaryPath = path.join(opts.reportsDir, 'coverage-summary.json');
-    let projectName = 'my-api';
-    let language = 'typescript';
-    let testFramework = 'jest';
-    let appImportPath = '../../src/app';
-    if (fs.existsSync(summaryPath)) {
-        try {
-            const summary = JSON.parse(fs.readFileSync(summaryPath, 'utf8'));
-            projectName = (_e = (_d = summary.project) === null || _d === void 0 ? void 0 : _d.name) !== null && _e !== void 0 ? _e : projectName;
-            language = (_g = (_f = summary.discoveryInfo) === null || _f === void 0 ? void 0 : _f.language) !== null && _g !== void 0 ? _g : language;
-            testFramework = (_j = (_h = summary.discoveryInfo) === null || _h === void 0 ? void 0 : _h.testFramework) !== null && _j !== void 0 ? _j : testFramework;
-            appImportPath = (_l = (_k = summary.discoveryInfo) === null || _k === void 0 ? void 0 : _k.appImportPath) !== null && _l !== void 0 ? _l : appImportPath;
-        }
-        catch {
-            // Use defaults
-        }
-    }
-    // Extract and filter gaps
-    let gaps = (0, gap_extractor_1.extractGapsFromReports)(opts.reportsDir);
-    gaps = (0, file_router_1.sortGapsByPriority)(gaps.filter(g => priorityGte(g.priority, minPriority)));
-    gaps = gaps.slice(0, maxGaps);
-    const aiGaps = [];
-    for (const gap of gaps) {
-        const suggestedOutputPath = (0, file_router_1.routeOutputFile)(gap, 'unit', 'tests', language);
-        const discoveryInfo = {
-            name: projectName,
-            language,
-            framework: 'express',
-            testFramework,
-            baseUrl: 'http://localhost:3000',
-            projectRoot: process.cwd(),
-            appImportPath,
-        };
-        const ctx = (0, context_builder_1.buildContext)(gap, suggestedOutputPath, discoveryInfo);
-        const generatedCode = (0, template_renderer_1.renderTemplate)(ctx, { language, testType: 'unit' });
-        const missingTestCases = buildMissingTestCases(gap);
-        const existingSimilarTests = findSimilarTests(gap.endpoint.path);
-        const aiGap = {
-            gapId: gap.id,
-            priority: gap.priority,
-            riskScore: gap.riskScore,
-            type: gap.type,
-            endpoint: {
-                method: gap.endpoint.method,
-                path: gap.endpoint.path,
-                auth: {
-                    required: gap.endpoint.auth.required,
-                    type: gap.endpoint.auth.type,
-                    scheme: gap.endpoint.auth.scheme,
-                },
-            },
-            missingTestCases,
-            copilotPrompt: '',
-            suggestedOutputPath,
-            existingSimilarTests,
-            generatedCode,
-        };
-        aiGap.copilotPrompt = buildCopilotPrompt(aiGap, projectName, testFramework, appImportPath);
-        aiGaps.push(aiGap);
-    }
-    const result = {
-        generatedAt: new Date().toISOString(),
-        project: {
-            name: projectName,
-            language,
-            testFramework,
-            appImportPath,
-        },
-        gaps: aiGaps,
-    };
-    // Write outputs
-    fs.mkdirSync(opts.outDir, { recursive: true });
-    if (format === 'json' || format === 'both') {
-        const jsonPath = path.join(opts.outDir, 'ai-ready-flows.json');
-        fs.writeFileSync(jsonPath, JSON.stringify(result, null, 2), 'utf8');
-        console.log(`AI flows JSON written to: ${jsonPath}`);
-    }
-    if (format === 'markdown' || format === 'both') {
-        const mdPath = path.join(opts.outDir, 'ai-ready-flows.md');
-        fs.writeFileSync(mdPath, buildMarkdown(result), 'utf8');
-        console.log(`AI flows Markdown written to: ${mdPath}`);
-    }
-    return result;
-}

package/dist/src/generation/context-builder.d.ts

@@ -1,16 +0,0 @@
-/**
- * Feature 28 — ContextBuilder
- * Assembles a GenerationContext from a DetectedGap and project discovery info.
- */
-import type { DetectedGap, GenerationContext } from './types';
-export interface ProjectDiscoveryInfo {
-    name: string;
-    language: string;
-    framework: string;
-    testFramework: string;
-    baseUrl: string;
-    projectRoot: string;
-    appImportPath?: string;
-}
-export declare function buildContext(gap: DetectedGap, outputFilePath: string, discovery: ProjectDiscoveryInfo): GenerationContext;
-//# sourceMappingURL=context-builder.d.ts.map

package/dist/src/generation/context-builder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../../src/generation/context-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EAGlB,MAAM,SAAS,CAAC;AAoFjB,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,YAAY,CAC1B,GAAG,EAAE,WAAW,EAChB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,oBAAoB,GAC9B,iBAAiB,CA8CnB"}

package/dist/src/generation/context-builder.js

@@ -1,170 +0,0 @@
-"use strict";
-/**
- * Feature 28 — ContextBuilder
- * Assembles a GenerationContext from a DetectedGap and project discovery info.
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildContext = buildContext;
-const path = __importStar(require("path"));
-// ─── Path normalisation ───────────────────────────────────────────────────────
-/**
- * Convert an OpenAPI-style path (/api/articles/{slug}) to framework-native
- * Express/supertest style (/api/articles/:slug).
- */
-function normalizePathParam(p) {
-    return p.replace(/\{([^}]+)\}/g, ':$1');
-}
-// ─── Fixture generation ───────────────────────────────────────────────────────
-function buildValidPayload(params) {
-    const payload = {};
-    for (const p of params) {
-        if (p.in !== 'body')
-            continue;
-        const { name, schema } = p;
-        payload[name] = generateExampleValue(schema);
-    }
-    return payload;
-}
-function buildInvalidPayload(params) {
-    const payload = {};
-    for (const p of params) {
-        if (p.in !== 'body' || !p.required)
-            continue;
-        // Omit required fields to create invalid payload
-    }
-    return payload;
-}
-function buildPathParams(pathTemplate) {
-    var _a;
-    const params = {};
-    const matches = (_a = pathTemplate.match(/\{([^}]+)\}/g)) !== null && _a !== void 0 ? _a : [];
-    for (const m of matches) {
-        const name = m.slice(1, -1);
-        if (name.toLowerCase().includes('id')) {
-            params[name] = '1';
-        }
-        else if (name.toLowerCase().includes('slug')) {
-            params[name] = 'test-slug';
-        }
-        else {
-            params[name] = 'test-value';
-        }
-    }
-    return params;
-}
-function generateExampleValue(schema) {
-    if (schema.enum && schema.enum.length > 0)
-        return schema.enum[0];
-    switch (schema.type) {
-        case 'string':
-            if (schema.format === 'email')
-                return 'test@example.com';
-            if (schema.format === 'date')
-                return '2026-01-01';
-            if (schema.format === 'date-time')
-                return '2026-01-01T00:00:00Z';
-            if (schema.format === 'uri')
-                return 'https://example.com';
-            if (schema.minLength && schema.minLength > 0)
-                return 'a'.repeat(schema.minLength);
-            return 'test-value';
-        case 'number':
-        case 'integer':
-            if (schema.minimum !== undefined)
-                return schema.minimum;
-            return 1;
-        case 'boolean':
-            return true;
-        case 'array':
-            return [];
-        case 'object':
-            return {};
-        default:
-            return 'test-value';
-    }
-}
-// ─── Import prefix computation ────────────────────────────────────────────────
-function computeImportPrefix(outputFilePath, projectRoot) {
-    const outDir = path.dirname(outputFilePath);
-    const rel = path.relative(outDir, path.join(projectRoot, 'src'));
-    return rel.startsWith('.') ? rel : `./${rel}`;
-}
-function buildContext(gap, outputFilePath, discovery) {
-    var _a, _b;
-    const importPrefix = computeImportPrefix(outputFilePath, discovery.projectRoot);
-    const params = (_a = gap.parameters) !== null && _a !== void 0 ? _a : [];
-    const responses = (_b = gap.responses) !== null && _b !== void 0 ? _b : [
-        { statusCode: 200, description: 'Success' },
-        { statusCode: 401, description: 'Unauthorized' },
-        { statusCode: 422, description: 'Unprocessable Entity' },
-    ];
-    return {
-        gap: {
-            id: gap.id,
-            type: gap.type,
-            priority: gap.priority,
-            riskScore: gap.riskScore,
-        },
-        endpoint: {
-            method: gap.endpoint.method,
-            path: gap.endpoint.path,
-            pathNormalized: normalizePathParam(gap.endpoint.path),
-            operationId: gap.endpoint.operationId,
-            summary: gap.endpoint.summary,
-            tags: gap.endpoint.tags,
-            auth: gap.endpoint.auth,
-        },
-        parameters: params,
-        responses,
-        fixtures: {
-            validPayload: buildValidPayload(params),
-            invalidPayload: buildInvalidPayload(params),
-            authToken: 'Bearer <your-test-token>',
-            pathParams: buildPathParams(gap.endpoint.path),
-        },
-        project: {
-            name: discovery.name,
-            language: discovery.language,
-            framework: discovery.framework,
-            testFramework: discovery.testFramework,
-            baseUrl: discovery.baseUrl,
-            importPrefix,
-        },
-        businessRule: gap.businessRule,
-        securityControl: gap.securityControl,
-        flow: gap.flow,
-    };
-}

package/dist/src/generation/engine.d.ts

@@ -1,19 +0,0 @@
-/**
- * Feature 28 — TestGenerationEngine
- * Main orchestrator for the test generation pipeline.
- *
- * Pipeline:
- *   GapList → GapClassifier → ContextBuilder → TemplateRenderer → FileRouter → FileWriter
- */
-import type { GenerationOptions, GenerationResult } from './types';
-export declare class TestGenerationEngine {
-    private opts;
-    private discovery;
-    constructor(opts: GenerationOptions);
-    run(): Promise<GenerationResult>;
-    private generateForGap;
-    private getTestTypes;
-    private writeFile;
-}
-export declare function generateTests(opts: GenerationOptions): Promise<GenerationResult>;
-//# sourceMappingURL=engine.d.ts.map

package/dist/src/generation/engine.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/generation/engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EAGV,iBAAiB,EACjB,gBAAgB,EAKjB,MAAM,SAAS,CAAC;AA6DjB,qBAAa,oBAAoB;IAGnB,OAAO,CAAC,IAAI;IAFxB,OAAO,CAAC,SAAS,CAAuB;gBAEpB,IAAI,EAAE,iBAAiB;IAQrC,GAAG,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAsDtC,OAAO,CAAC,cAAc;IAyBtB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,SAAS;CAUlB;AAID,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAGtF"}