api-tests-coverage 1.0.17 → 1.0.18

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

@@ -0,0 +1,170 @@
+"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

@@ -0,0 +1,19 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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"}

package/dist/src/generation/engine.js

@@ -0,0 +1,204 @@
+"use strict";
+/**
+ * Feature 28 — TestGenerationEngine
+ * Main orchestrator for the test generation pipeline.
+ *
+ * Pipeline:
+ *   GapList → GapClassifier → ContextBuilder → TemplateRenderer → FileRouter → FileWriter
+ */
+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.TestGenerationEngine = void 0;
+exports.generateTests = generateTests;
+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 ordering ────────────────────────────────────────────────────────
+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];
+}
+// ─── Gap → test type mapping (Section 1.1 of spec) ───────────────────────────
+const GAP_GENERATOR_MAP = {
+    endpoint: ['unit', 'integration', 'cypress'],
+    parameter: ['unit', 'integration'],
+    error: ['unit', 'integration'],
+    business: ['unit', 'integration'],
+    integration: ['integration', 'cypress'],
+    security: ['security', 'unit'],
+    auth: ['unit', 'integration', 'security'],
+};
+// ─── Discovery info loader ────────────────────────────────────────────────────
+function loadDiscoveryInfo(reportsDir) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    const summaryPath = path.join(reportsDir, 'coverage-summary.json');
+    if (fs.existsSync(summaryPath)) {
+        try {
+            const summary = JSON.parse(fs.readFileSync(summaryPath, 'utf8'));
+            const di = (_a = summary.discoveryInfo) !== null && _a !== void 0 ? _a : {};
+            return {
+                name: (_d = (_b = di.name) !== null && _b !== void 0 ? _b : (_c = summary.project) === null || _c === void 0 ? void 0 : _c.name) !== null && _d !== void 0 ? _d : 'my-api',
+                language: (_e = di.language) !== null && _e !== void 0 ? _e : 'typescript',
+                framework: (_f = di.framework) !== null && _f !== void 0 ? _f : 'express',
+                testFramework: (_g = di.testFramework) !== null && _g !== void 0 ? _g : 'jest',
+                baseUrl: 'http://localhost:3000',
+                projectRoot: process.cwd(),
+                appImportPath: di.appImportPath,
+            };
+        }
+        catch {
+            // Fall through to defaults
+        }
+    }
+    return {
+        name: 'my-api',
+        language: 'typescript',
+        framework: 'express',
+        testFramework: 'jest',
+        baseUrl: 'http://localhost:3000',
+        projectRoot: process.cwd(),
+    };
+}
+// ─── Engine ───────────────────────────────────────────────────────────────────
+class TestGenerationEngine {
+    constructor(opts) {
+        this.opts = opts;
+        this.discovery = loadDiscoveryInfo(opts.reportsDir);
+        // Override detection with CLI options
+        if (opts.language)
+            this.discovery.language = opts.language;
+        if (opts.framework)
+            this.discovery.framework = opts.framework;
+    }
+    async run() {
+        var _a, _b;
+        const result = {
+            files: [],
+            dryRun: (_a = this.opts.dryRun) !== null && _a !== void 0 ? _a : false,
+            totalGaps: 0,
+            generatedCount: 0,
+            skippedCount: 0,
+            errors: [],
+        };
+        // 1. Extract gaps from reports
+        let gaps = (0, gap_extractor_1.extractGapsFromReports)(this.opts.reportsDir);
+        // 2. Filter by specific gap ID if requested
+        if (this.opts.gapId) {
+            gaps = gaps.filter(g => g.id === this.opts.gapId);
+        }
+        // 3. Filter by priority
+        const minPriority = (_b = this.opts.priority) !== null && _b !== void 0 ? _b : 'P1';
+        gaps = gaps.filter(g => priorityGte(g.priority, minPriority));
+        // 4. Filter by type
+        if (this.opts.types && this.opts.types.length > 0) {
+            gaps = gaps.filter(g => this.opts.types.includes(g.type));
+        }
+        // 5. Sort by priority (P0 first)
+        gaps = (0, file_router_1.sortGapsByPriority)(gaps);
+        result.totalGaps = gaps.length;
+        // 6. Generate files for each gap
+        for (const gap of gaps) {
+            try {
+                const generated = this.generateForGap(gap);
+                for (const file of generated) {
+                    result.files.push(file);
+                    if (!this.opts.dryRun) {
+                        this.writeFile(file);
+                    }
+                    result.generatedCount++;
+                }
+            }
+            catch (err) {
+                result.errors.push({
+                    gapId: gap.id,
+                    message: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        return result;
+    }
+    generateForGap(gap) {
+        const files = [];
+        const testTypes = this.getTestTypes(gap);
+        const language = this.discovery.language;
+        const convention = 'kebab';
+        for (const testType of testTypes) {
+            const outputPath = (0, file_router_1.routeOutputFile)(gap, testType, this.opts.outDir, language, convention);
+            const ctx = (0, context_builder_1.buildContext)(gap, outputPath, this.discovery);
+            const content = (0, template_renderer_1.renderTemplate)(ctx, { language, testType });
+            files.push({
+                gapId: gap.id,
+                filePath: path.resolve(outputPath),
+                relativePath: outputPath,
+                content,
+                testType,
+                language,
+                framework: this.discovery.testFramework,
+            });
+        }
+        return files;
+    }
+    getTestTypes(gap) {
+        var _a;
+        let types = (_a = GAP_GENERATOR_MAP[gap.type]) !== null && _a !== void 0 ? _a : ['unit'];
+        // Apply exclusion flags
+        if (this.opts.noSecurity) {
+            types = types.filter(t => t !== 'security');
+        }
+        if (this.opts.noCypress) {
+            types = types.filter(t => t !== 'cypress');
+        }
+        return types;
+    }
+    writeFile(file) {
+        const dir = path.dirname(file.relativePath);
+        fs.mkdirSync(dir, { recursive: true });
+        if (fs.existsSync(file.relativePath) && !this.opts.overwrite) {
+            return;
+        }
+        fs.writeFileSync(file.relativePath, file.content, 'utf8');
+    }
+}
+exports.TestGenerationEngine = TestGenerationEngine;
+// ─── Public API ───────────────────────────────────────────────────────────────
+async function generateTests(opts) {
+    const engine = new TestGenerationEngine(opts);
+    return engine.run();
+}

package/dist/src/generation/file-router.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Feature 28 — FileRouter
+ * Determines output file paths for generated test files.
+ */
+import type { DetectedGap, TestType, FileNamingConvention } from './types';
+export declare function routeOutputFile(gap: DetectedGap, testType: TestType, outDir: string, language: string, convention?: FileNamingConvention): string;
+export declare function sortGapsByPriority(gaps: DetectedGap[]): DetectedGap[];
+//# sourceMappingURL=file-router.d.ts.map

package/dist/src/generation/file-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-router.d.ts","sourceRoot":"","sources":["../../../src/generation/file-router.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAyC3E,wBAAgB,eAAe,CAC7B,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,GAAE,oBAA8B,GACzC,MAAM,CAoBR;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAErE"}

package/dist/src/generation/file-router.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * Feature 28 — FileRouter
+ * Determines output file paths for generated test files.
+ */
+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.routeOutputFile = routeOutputFile;
+exports.sortGapsByPriority = sortGapsByPriority;
+const path = __importStar(require("path"));
+const PRIORITY_ORDER = { P0: 0, P1: 1, P2: 2, P3: 3, P4: 4, P5: 5 };
+function toKebab(s) {
+    return s
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        .replace(/[^a-zA-Z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .toLowerCase();
+}
+function toCamel(s) {
+    return toKebab(s)
+        .split('-')
+        .map((w, i) => (i === 0 ? w : w.charAt(0).toUpperCase() + w.slice(1)))
+        .join('');
+}
+function toSnake(s) {
+    return toKebab(s).replace(/-/g, '_');
+}
+function applyNaming(name, convention) {
+    switch (convention) {
+        case 'camelCase': return toCamel(name);
+        case 'snake_case': return toSnake(name);
+        case 'kebab':
+        default: return toKebab(name);
+    }
+}
+function pathToFileName(method, apiPath, convention) {
+    const parts = apiPath
+        .split('/')
+        .filter(Boolean)
+        .map(p => p.replace(/[{}]/g, '').replace(/[^a-zA-Z0-9]/g, '-'));
+    const base = [...parts, method.toLowerCase()].join('-');
+    return applyNaming(base, convention);
+}
+function routeOutputFile(gap, testType, outDir, language, convention = 'kebab') {
+    const method = gap.endpoint.method.toLowerCase();
+    const apiPath = gap.endpoint.path;
+    const baseName = pathToFileName(method, apiPath, convention);
+    switch (testType) {
+        case 'security':
+            return path.join(outDir, 'security', `${baseName}.security.test.ts`);
+        case 'cypress':
+            return path.join('cypress', 'e2e', 'generated', `${baseName}.cy.js`);
+        case 'integration':
+            if (gap.flow) {
+                const flowName = applyNaming(gap.flow.name, convention);
+                return path.join(outDir, 'flows', `${flowName}.flow.test.ts`);
+            }
+            return path.join(outDir, `${baseName}.integration.test.ts`);
+        case 'unit':
+        default:
+            return path.join(outDir, `${baseName}.test.ts`);
+    }
+}
+function sortGapsByPriority(gaps) {
+    return [...gaps].sort((a, b) => { var _a, _b; return ((_a = PRIORITY_ORDER[a.priority]) !== null && _a !== void 0 ? _a : 99) - ((_b = PRIORITY_ORDER[b.priority]) !== null && _b !== void 0 ? _b : 99); });
+}

package/dist/src/generation/gap-extractor.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Feature 28 — GapExtractor
+ * Reads coverage-summary.json (or coverage reports) and extracts DetectedGap objects.
+ */
+import type { DetectedGap } from './types';
+export declare function extractGapsFromReports(reportsDir: string): DetectedGap[];
+//# sourceMappingURL=gap-extractor.d.ts.map

package/dist/src/generation/gap-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gap-extractor.d.ts","sourceRoot":"","sources":["../../../src/generation/gap-extractor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAoC,MAAM,SAAS,CAAC;AA4D7E,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,EAAE,CAmLxE"}