api-tests-coverage 1.0.17 → 1.0.19

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"}

package/dist/src/generation/gap-extractor.js

@@ -0,0 +1,291 @@
+"use strict";
+/**
+ * Feature 28 — GapExtractor
+ * Reads coverage-summary.json (or coverage reports) and extracts DetectedGap objects.
+ */
+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.extractGapsFromReports = extractGapsFromReports;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// ─── Priority logic ───────────────────────────────────────────────────────────
+function computePriority(type, authRequired, riskScore) {
+    if (type === 'security' || (type === 'auth' && authRequired))
+        return 'P0';
+    if (type === 'endpoint')
+        return 'P1';
+    if (type === 'error')
+        return 'P2';
+    if (type === 'business')
+        return 'P3';
+    if (type === 'parameter')
+        return 'P4';
+    if (type === 'integration')
+        return 'P5';
+    return 'P3';
+}
+function buildGapId(type, method, apiPath, condition) {
+    return `${type}:${method.toUpperCase()}:${apiPath}:${condition}`;
+}
+// ─── Summary JSON reader ──────────────────────────────────────────────────────
+function readJson(filePath) {
+    if (!fs.existsSync(filePath))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+// ─── Public API ───────────────────────────────────────────────────────────────
+function extractGapsFromReports(reportsDir) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _13, _14, _15, _16, _17, _18, _19, _20, _21, _22, _23, _24;
+    const gaps = [];
+    // Try coverage-summary.json first
+    const summaryPath = path.join(reportsDir, 'coverage-summary.json');
+    const summary = readJson(summaryPath);
+    if (!summary) {
+        // Return synthetic sample gaps for smoke-test / dry-run mode
+        return buildSampleGaps();
+    }
+    // ── Endpoint gaps ─────────────────────────────────────────────────────────
+    const endpointItems = (_c = (_b = (_a = summary.details) === null || _a === void 0 ? void 0 : _a.endpoint) === null || _b === void 0 ? void 0 : _b.items) !== null && _c !== void 0 ? _c : [];
+    for (const item of endpointItems) {
+        if (item.covered)
+            continue;
+        const method = ((_d = item.method) !== null && _d !== void 0 ? _d : 'GET').toUpperCase();
+        const apiPath = (_e = item.path) !== null && _e !== void 0 ? _e : '/unknown';
+        const authRequired = (_f = item.authRequired) !== null && _f !== void 0 ? _f : false;
+        const authOptional = (_g = item.authOptional) !== null && _g !== void 0 ? _g : false;
+        const riskScore = authRequired ? 85 : 60;
+        gaps.push({
+            id: buildGapId('endpoint', method, apiPath, 'uncovered'),
+            type: 'endpoint',
+            priority: computePriority('endpoint', authRequired, riskScore),
+            riskScore,
+            endpoint: {
+                method,
+                path: apiPath,
+                operationId: item.operationId,
+                tags: item.tags,
+                auth: {
+                    required: authRequired,
+                    optional: authOptional,
+                    type: authRequired ? 'jwt' : undefined,
+                    headerName: authRequired ? 'Authorization' : undefined,
+                    scheme: authRequired ? 'Bearer' : undefined,
+                },
+            },
+            responses: [
+                { statusCode: 200, description: 'Success' },
+                ...(authRequired ? [{ statusCode: 401, description: 'Unauthorized' }] : []),
+                { statusCode: 422, description: 'Unprocessable Entity' },
+            ],
+        });
+    }
+    // ── Security gaps ─────────────────────────────────────────────────────────
+    const securityItems = (_k = (_j = (_h = summary.details) === null || _h === void 0 ? void 0 : _h.security) === null || _j === void 0 ? void 0 : _j.items) !== null && _k !== void 0 ? _k : [];
+    for (const item of securityItems) {
+        if (item.covered)
+            continue;
+        const parts = ((_l = item.endpoint) !== null && _l !== void 0 ? _l : 'GET /unknown').split(' ');
+        const method = ((_m = parts[0]) !== null && _m !== void 0 ? _m : 'GET').toUpperCase();
+        const apiPath = (_o = parts[1]) !== null && _o !== void 0 ? _o : '/unknown';
+        gaps.push({
+            id: buildGapId('security', method, apiPath, (_p = item.controlType) !== null && _p !== void 0 ? _p : 'auth-bypass'),
+            type: 'security',
+            priority: 'P0',
+            riskScore: 95,
+            endpoint: {
+                method,
+                path: apiPath,
+                auth: { required: true, optional: false, type: 'jwt', headerName: 'Authorization', scheme: 'Bearer' },
+            },
+            securityControl: {
+                type: (_q = item.controlType) !== null && _q !== void 0 ? _q : 'auth-bypass',
+                description: `Security control not tested for ${item.endpoint}`,
+                attackVector: 'Missing auth validation test',
+                expectedStatusCode: 401,
+            },
+        });
+    }
+    // ── Error gaps ────────────────────────────────────────────────────────────
+    const errorItems = (_t = (_s = (_r = summary.details) === null || _r === void 0 ? void 0 : _r.error) === null || _s === void 0 ? void 0 : _s.items) !== null && _t !== void 0 ? _t : [];
+    for (const item of errorItems) {
+        if (item.covered)
+            continue;
+        const parts = ((_u = item.endpoint) !== null && _u !== void 0 ? _u : 'GET /unknown').split(' ');
+        const method = ((_v = parts[0]) !== null && _v !== void 0 ? _v : 'GET').toUpperCase();
+        const apiPath = (_w = parts[1]) !== null && _w !== void 0 ? _w : '/unknown';
+        const statusCode = (_x = item.statusCode) !== null && _x !== void 0 ? _x : 500;
+        gaps.push({
+            id: buildGapId('error', method, apiPath, String(statusCode)),
+            type: 'error',
+            priority: 'P2',
+            riskScore: 65,
+            endpoint: {
+                method,
+                path: apiPath,
+                auth: { required: false, optional: false },
+            },
+            responses: [{ statusCode, description: `Error ${statusCode} not tested` }],
+        });
+    }
+    // ── Business rule gaps ────────────────────────────────────────────────────
+    const businessItems = (_0 = (_z = (_y = summary.details) === null || _y === void 0 ? void 0 : _y.business) === null || _z === void 0 ? void 0 : _z.items) !== null && _0 !== void 0 ? _0 : [];
+    for (const item of businessItems) {
+        if (item.covered)
+            continue;
+        const parts = ((_1 = item.endpoint) !== null && _1 !== void 0 ? _1 : 'GET /unknown').split(' ');
+        const method = ((_2 = parts[0]) !== null && _2 !== void 0 ? _2 : 'GET').toUpperCase();
+        const apiPath = (_3 = parts[1]) !== null && _3 !== void 0 ? _3 : '/unknown';
+        gaps.push({
+            id: buildGapId('business', method, apiPath, (_4 = item.ruleId) !== null && _4 !== void 0 ? _4 : 'business-rule'),
+            type: 'business',
+            priority: 'P3',
+            riskScore: 55,
+            endpoint: {
+                method,
+                path: apiPath,
+                auth: { required: false, optional: false },
+            },
+            businessRule: {
+                id: (_5 = item.ruleId) !== null && _5 !== void 0 ? _5 : 'rule-1',
+                description: (_6 = item.description) !== null && _6 !== void 0 ? _6 : 'Business rule not covered',
+                condition: 'When condition is met',
+                acceptanceCriteria: ['Expected behavior is verified'],
+            },
+        });
+    }
+    // ── Integration flow gaps ─────────────────────────────────────────────────
+    const integrationItems = (_9 = (_8 = (_7 = summary.details) === null || _7 === void 0 ? void 0 : _7.integration) === null || _8 === void 0 ? void 0 : _8.items) !== null && _9 !== void 0 ? _9 : [];
+    for (const item of integrationItems) {
+        if (item.covered)
+            continue;
+        gaps.push({
+            id: `integration:${(_10 = item.flowId) !== null && _10 !== void 0 ? _10 : 'flow'}:step-${(_11 = item.missingStepIndex) !== null && _11 !== void 0 ? _11 : 0}-missing`,
+            type: 'integration',
+            priority: 'P5',
+            riskScore: 45,
+            endpoint: {
+                method: 'GET',
+                path: '/unknown',
+                auth: { required: false, optional: false },
+            },
+            flow: {
+                id: (_12 = item.flowId) !== null && _12 !== void 0 ? _12 : 'flow-1',
+                name: (_13 = item.name) !== null && _13 !== void 0 ? _13 : 'Integration Flow',
+                steps: (_14 = item.steps) !== null && _14 !== void 0 ? _14 : [],
+                missingStepIndex: (_15 = item.missingStepIndex) !== null && _15 !== void 0 ? _15 : 0,
+            },
+        });
+    }
+    // ── Parameter gaps ────────────────────────────────────────────────────────
+    const parameterItems = (_18 = (_17 = (_16 = summary.details) === null || _16 === void 0 ? void 0 : _16.parameter) === null || _17 === void 0 ? void 0 : _17.items) !== null && _18 !== void 0 ? _18 : [];
+    for (const item of parameterItems) {
+        const parts = ((_19 = item.endpoint) !== null && _19 !== void 0 ? _19 : 'GET /unknown').split(' ');
+        const method = ((_20 = parts[0]) !== null && _20 !== void 0 ? _20 : 'GET').toUpperCase();
+        const apiPath = (_21 = parts[1]) !== null && _21 !== void 0 ? _21 : '/unknown';
+        const paramName = (_22 = item.parameter) !== null && _22 !== void 0 ? _22 : 'param';
+        const missingCases = ((_23 = item.missingCases) !== null && _23 !== void 0 ? _23 : ['boundary-min']);
+        const condition = (_24 = missingCases[0]) !== null && _24 !== void 0 ? _24 : 'boundary';
+        gaps.push({
+            id: buildGapId('parameter', method, apiPath, `${paramName}:${condition}`),
+            type: 'parameter',
+            priority: 'P4',
+            riskScore: 40,
+            endpoint: {
+                method,
+                path: apiPath,
+                auth: { required: false, optional: false },
+            },
+            parameters: [{
+                    name: paramName,
+                    in: 'query',
+                    required: false,
+                    schema: { type: 'string' },
+                    missingCases,
+                }],
+        });
+    }
+    return gaps;
+}
+/** Build a minimal set of synthetic gaps for smoke-test / dry-run mode */
+function buildSampleGaps() {
+    return [
+        {
+            id: 'endpoint:POST:/api/articles:uncovered',
+            type: 'endpoint',
+            priority: 'P1',
+            riskScore: 85,
+            endpoint: {
+                method: 'POST',
+                path: '/api/articles',
+                operationId: 'createArticle',
+                summary: 'Create Article',
+                auth: { required: true, optional: false, type: 'jwt', headerName: 'Authorization', scheme: 'Bearer' },
+            },
+            parameters: [
+                {
+                    name: 'title',
+                    in: 'body',
+                    required: true,
+                    schema: { type: 'string', minLength: 1 },
+                    missingCases: ['missing-required'],
+                },
+                {
+                    name: 'body',
+                    in: 'body',
+                    required: true,
+                    schema: { type: 'string' },
+                    missingCases: ['missing-required'],
+                },
+                {
+                    name: 'description',
+                    in: 'body',
+                    required: true,
+                    schema: { type: 'string' },
+                    missingCases: ['missing-required'],
+                },
+            ],
+            responses: [
+                { statusCode: 201, description: 'Created' },
+                { statusCode: 401, description: 'Unauthorized' },
+                { statusCode: 422, description: 'Unprocessable Entity' },
+            ],
+        },
+    ];
+}

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

@@ -0,0 +1,9 @@
+/**
+ * Feature 28 — Test Generation & Quality Intelligence Engine
+ * Public API exports
+ */
+export { TestGenerationEngine, generateTests } from './engine';
+export { scoreTests, scoreFile } from './quality-scorer';
+export { exportAiFlows } from './ai-flow-exporter';
+export type { DetectedGap, GeneratedFile, GenerationResult, GenerationOptions, TestQualityReport, FileQualityScore, AiReadyFlows, AiFlowGap, AiFlowExporterOptions, GenerationConfig, TestQualityConfig, AiFlowsConfig, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generation/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EACV,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,GACd,MAAM,SAAS,CAAC"}

package/dist/src/generation/index.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Feature 28 — Test Generation & Quality Intelligence Engine
+ * Public API exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exportAiFlows = exports.scoreFile = exports.scoreTests = exports.generateTests = exports.TestGenerationEngine = void 0;
+var engine_1 = require("./engine");
+Object.defineProperty(exports, "TestGenerationEngine", { enumerable: true, get: function () { return engine_1.TestGenerationEngine; } });
+Object.defineProperty(exports, "generateTests", { enumerable: true, get: function () { return engine_1.generateTests; } });
+var quality_scorer_1 = require("./quality-scorer");
+Object.defineProperty(exports, "scoreTests", { enumerable: true, get: function () { return quality_scorer_1.scoreTests; } });
+Object.defineProperty(exports, "scoreFile", { enumerable: true, get: function () { return quality_scorer_1.scoreFile; } });
+var ai_flow_exporter_1 = require("./ai-flow-exporter");
+Object.defineProperty(exports, "exportAiFlows", { enumerable: true, get: function () { return ai_flow_exporter_1.exportAiFlows; } });

package/dist/src/generation/quality-scorer.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Feature 28 — QualityScorer
+ * Scores existing test files on 5 dimensions (0–100 total).
+ *
+ * Dimensions (20 pts each):
+ *   1. Assertion Depth
+ *   2. Negative Path Coverage
+ *   3. Auth Coverage
+ *   4. Boundary Coverage
+ *   5. Test Independence
+ */
+import type { FileQualityScore, TestQualityReport, QualityScorerOptions } from './types';
+export declare function scoreFile(filePath: string): FileQualityScore;
+export declare function scoreTests(opts: QualityScorerOptions): Promise<TestQualityReport>;
+//# sourceMappingURL=quality-scorer.d.ts.map

package/dist/src/generation/quality-scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-scorer.d.ts","sourceRoot":"","sources":["../../../src/generation/quality-scorer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EACV,gBAAgB,EAEhB,iBAAiB,EACjB,oBAAoB,EAErB,MAAM,SAAS,CAAC;AA8JjB,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAoB5D;AAID,wBAAsB,UAAU,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAsEvF"}