api-tests-coverage 1.0.0

package/dist/src/coverage/deep-analysis/resolveRequestWrappers.js

@@ -0,0 +1,226 @@
+"use strict";
+/**
+ * Deep Code Analysis — Request Object and Builder Pattern Resolution
+ *
+ * Detects and resolves HTTP calls that are hidden inside request object
+ * construction or builder patterns.
+ *
+ * Supported patterns:
+ *
+ * TypeScript/JavaScript:
+ *   const request = new ApiRequest('GET', '/users');
+ *   client.execute(request);
+ *
+ * Java:
+ *   Request req = Request.builder().method(GET).path("/users").build();
+ *   client.execute(req);
+ *
+ * Kotlin:
+ *   val req = RequestBuilder().get().path("/users").build()
+ *   api.execute(req)
+ *
+ * Python:
+ *   request = ApiRequest(method='GET', path='/users')
+ *   client.execute(request)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractJsRequestBuilders = extractJsRequestBuilders;
+exports.extractJavaRequestBuilders = extractJavaRequestBuilders;
+exports.extractKotlinRequestBuilders = extractKotlinRequestBuilders;
+exports.extractPythonRequestBuilders = extractPythonRequestBuilders;
+exports.extractRequestBuilders = extractRequestBuilders;
+const resolvePaths_1 = require("./resolvePaths");
+const resolveConstants_1 = require("./resolveConstants");
+// ─── TypeScript / JavaScript ──────────────────────────────────────────────────
+/**
+ * Extract HTTP calls from TypeScript/JavaScript request object and builder patterns.
+ *
+ * Detects:
+ *   new ApiRequest('GET', '/users')
+ *   new Request({ method: 'GET', url: '/users' })
+ *   ApiRequest.create({ method: 'get', path: '/users' })
+ */
+function extractJsRequestBuilders(content, table) {
+    var _a, _b, _c;
+    const calls = [];
+    let m;
+    // new SomeRequest('METHOD', '/path')
+    const ctorPattern = /new\s+[A-Za-z][A-Za-z0-9_]*Request\s*\(\s*['"`](GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)[`'"]\s*,\s*['"`]([^'"`]+)['"`]/gi;
+    while ((m = ctorPattern.exec(content)) !== null) {
+        const path = (_a = (0, resolveConstants_1.resolveToken)(m[2], table)) !== null && _a !== void 0 ? _a : m[2];
+        const normalized = (0, resolvePaths_1.normalizePathToTemplate)(path);
+        calls.push({
+            method: m[1].toUpperCase(),
+            path,
+            normalizedPath: normalized !== path ? normalized : undefined,
+            confidence: 'high',
+            pattern: 'constructor(method, path)',
+        });
+    }
+    // { method: 'GET', url: '/path' } or { method: 'GET', path: '/path' }
+    const objLiteralPattern = /\{\s*(?:method|verb)\s*:\s*['"`](GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)['"`]\s*,\s*(?:url|path|endpoint)\s*:\s*['"`]([^'"`]+)['"`]/gi;
+    while ((m = objLiteralPattern.exec(content)) !== null) {
+        const path = (_b = (0, resolveConstants_1.resolveToken)(m[2], table)) !== null && _b !== void 0 ? _b : m[2];
+        const normalized = (0, resolvePaths_1.normalizePathToTemplate)(path);
+        calls.push({
+            method: m[1].toUpperCase(),
+            path,
+            normalizedPath: normalized !== path ? normalized : undefined,
+            confidence: 'high',
+            pattern: 'object literal {method, path}',
+        });
+    }
+    // fetch('/path', { method: 'POST' })
+    const fetchPattern = /\bfetch\s*\(\s*['"`]([^'"`]+)['"`]\s*,\s*\{[^}]*(?:method|verb)\s*:\s*['"`](GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)['"`]/gi;
+    while ((m = fetchPattern.exec(content)) !== null) {
+        const path = (_c = (0, resolveConstants_1.resolveToken)(m[1], table)) !== null && _c !== void 0 ? _c : m[1];
+        const normalized = (0, resolvePaths_1.normalizePathToTemplate)(path);
+        calls.push({
+            method: m[2].toUpperCase(),
+            path,
+            normalizedPath: normalized !== path ? normalized : undefined,
+            confidence: 'high',
+            pattern: 'fetch(url, {method})',
+        });
+    }
+    return calls;
+}
+// ─── Java ─────────────────────────────────────────────────────────────────────
+/**
+ * Extract HTTP calls from Java builder patterns.
+ *
+ * Detects:
+ *   Request.builder().method(HttpMethod.GET).path("/users").build()
+ *   new HttpRequest.Builder().uri("/users").method("GET", ...).build()
+ *   MockMvcRequestBuilders.get("/users")
+ */
+function extractJavaRequestBuilders(content, table) {
+    var _a, _b;
+    const calls = [];
+    let m;
+    // .method(GET|HttpMethod.GET|"GET").path("/users") or reversed
+    const builderMethodPath = /\.method\s*\(\s*(?:HttpMethod\.)?["']?(GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)["']?\s*[,)][^;]*\.(?:path|uri)\s*\(\s*"([^"]+)"/gi;
+    while ((m = builderMethodPath.exec(content)) !== null) {
+        const path = (_a = (0, resolveConstants_1.resolveToken)(m[2], table)) !== null && _a !== void 0 ? _a : m[2];
+        const normalized = (0, resolvePaths_1.normalizePathToTemplate)(path);
+        calls.push({
+            method: m[1].toUpperCase(),
+            path,
+            normalizedPath: normalized !== path ? normalized : undefined,
+            confidence: 'high',
+            pattern: 'builder .method().path()',
+        });
+    }
+    // .path("/users").method("GET") reversed order
+    const builderPathMethod = /\.(?:path|uri)\s*\(\s*"([^"]+)"\s*\)[^;]*\.method\s*\(\s*(?:HttpMethod\.)?["']?(GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)/gi;
+    while ((m = builderPathMethod.exec(content)) !== null) {
+        const path = (_b = (0, resolveConstants_1.resolveToken)(m[1], table)) !== null && _b !== void 0 ? _b : m[1];
+        const normalized = (0, resolvePaths_1.normalizePathToTemplate)(path);
+        calls.push({
+            method: m[2].toUpperCase(),
+            path,
+            normalizedPath: normalized !== path ? normalized : undefined,
+            confidence: 'high',
+            pattern: 'builder .path().method()',
+        });
+    }
+    return calls;
+}
+// ─── Kotlin ───────────────────────────────────────────────────────────────────
+/**
+ * Extract HTTP calls from Kotlin builder patterns.
+ *
+ * Detects:
+ *   RequestBuilder().get().path("/users").build()
+ *   val req = RequestBuilder().method("GET").path("/users").build()
+ */
+function extractKotlinRequestBuilders(content, table) {
+    var _a, _b;
+    const calls = [];
+    let m;
+    // .get().path("/users") — method via chain method name
+    const chainPattern = /\.(get|post|put|patch|delete|head|options)\s*\(\s*\)\s*\.path\s*\(\s*["']([^"']+)["']/gi;
+    while ((m = chainPattern.exec(content)) !== null) {
+        const path = (_a = (0, resolveConstants_1.resolveToken)(m[2], table)) !== null && _a !== void 0 ? _a : m[2];
+        const normalized = (0, resolvePaths_1.normalizePathToTemplate)(path);
+        calls.push({
+            method: m[1].toUpperCase(),
+            path,
+            normalizedPath: normalized !== path ? normalized : undefined,
+            confidence: 'high',
+            pattern: 'builder .method().path()',
+        });
+    }
+    // .method("GET").path("/users")
+    const methodPathPattern = /\.method\s*\(\s*["']?(GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)["']?\s*\)\s*\.path\s*\(\s*["']([^"']+)["']/gi;
+    while ((m = methodPathPattern.exec(content)) !== null) {
+        const path = (_b = (0, resolveConstants_1.resolveToken)(m[2], table)) !== null && _b !== void 0 ? _b : m[2];
+        const normalized = (0, resolvePaths_1.normalizePathToTemplate)(path);
+        calls.push({
+            method: m[1].toUpperCase(),
+            path,
+            normalizedPath: normalized !== path ? normalized : undefined,
+            confidence: 'high',
+            pattern: 'builder .method().path()',
+        });
+    }
+    return calls;
+}
+// ─── Python ───────────────────────────────────────────────────────────────────
+/**
+ * Extract HTTP calls from Python request object patterns.
+ *
+ * Detects:
+ *   ApiRequest(method='GET', path='/users')
+ *   requests.Request('GET', '/users')
+ */
+function extractPythonRequestBuilders(content, table) {
+    var _a, _b;
+    const calls = [];
+    let m;
+    // ApiRequest(method='GET', path='/users')
+    const kwPattern = /\w+\s*\(\s*method\s*=\s*['"`](GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)['"`]\s*,\s*(?:path|url|endpoint)\s*=\s*['"`]([^'"`]+)['"`]/gi;
+    while ((m = kwPattern.exec(content)) !== null) {
+        const path = (_a = (0, resolveConstants_1.resolveToken)(m[2], table)) !== null && _a !== void 0 ? _a : m[2];
+        const normalized = (0, resolvePaths_1.normalizePathToTemplate)(path);
+        calls.push({
+            method: m[1].toUpperCase(),
+            path,
+            normalizedPath: normalized !== path ? normalized : undefined,
+            confidence: 'high',
+            pattern: 'Request(method=, path=)',
+        });
+    }
+    // requests.Request('GET', 'http://host/path')
+    const posPattern = /requests\.Request\s*\(\s*['"`](GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)['"`]\s*,\s*['"`]([^'"`]+)['"`]/gi;
+    while ((m = posPattern.exec(content)) !== null) {
+        const path = (_b = (0, resolveConstants_1.resolveToken)(m[2], table)) !== null && _b !== void 0 ? _b : m[2];
+        const normalized = (0, resolvePaths_1.normalizePathToTemplate)(path);
+        calls.push({
+            method: m[1].toUpperCase(),
+            path,
+            normalizedPath: normalized !== path ? normalized : undefined,
+            confidence: 'high',
+            pattern: 'requests.Request(method, url)',
+        });
+    }
+    return calls;
+}
+// ─── Dispatcher ───────────────────────────────────────────────────────────────
+/**
+ * Extract request builder / request object HTTP calls for any supported language.
+ */
+function extractRequestBuilders(content, language, table) {
+    switch (language) {
+        case 'java':
+            return extractJavaRequestBuilders(content, table);
+        case 'kotlin':
+            return [...extractKotlinRequestBuilders(content, table), ...extractJavaRequestBuilders(content, table)];
+        case 'python':
+            return extractPythonRequestBuilders(content, table);
+        case 'typescript':
+        case 'javascript':
+        default:
+            return extractJsRequestBuilders(content, table);
+    }
+}

package/dist/src/coverage/deep-analysis/symbolTable.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Deep Code Analysis — Symbol Table
+ *
+ * Extracts named symbols (constants, variables, enum members) from source
+ * file content across all supported languages and builds a per-file symbol
+ * table for downstream resolvers.
+ */
+import type { SymbolTable } from './types';
+/**
+ * Extract symbols from TypeScript/JavaScript source.
+ *
+ * Captures:
+ *   - const NAME = 'value'   (top-level and local)
+ *   - let NAME = 'value'
+ *   - var NAME = 'value'
+ *   - enum Foo { MEMBER = 'value' }  (string enums)
+ *   - const obj = { key: 'value' }  — top-level object property literals
+ */
+export declare function buildSymbolTableFromJs(content: string): SymbolTable;
+/**
+ * Extract symbols from Java source.
+ *
+ * Captures:
+ *   - static final String NAME = "value";
+ *   - final String NAME = "value";
+ *   - String NAME = "value";
+ *   - enum Routes { USERS("/users"), ... }  (constructor-style enums)
+ */
+export declare function buildSymbolTableFromJava(content: string): SymbolTable;
+/**
+ * Extract symbols from Kotlin source.
+ *
+ * Captures:
+ *   - const val NAME = "value"
+ *   - val NAME = "value"
+ *   - enum class Routes(val path: String) { USERS("/users"), ... }
+ *   - object Constants { const val NAME = "value" }
+ */
+export declare function buildSymbolTableFromKotlin(content: string): SymbolTable;
+/**
+ * Extract symbols from Python source.
+ *
+ * Captures:
+ *   - UPPER_CASE = "/path"   (module-level constants)
+ *   - class Routes(Enum): USERS = "/users"
+ */
+export declare function buildSymbolTableFromPython(content: string): SymbolTable;
+/**
+ * Build a symbol table from source content for the given language.
+ */
+export declare function buildSymbolTable(content: string, language: 'typescript' | 'javascript' | 'java' | 'kotlin' | 'python' | 'ruby' | 'cucumber' | 'auto'): SymbolTable;
+/**
+ * Resolve a symbol name to its string value using the table.
+ * Returns undefined when the symbol is not found or has no static value.
+ * Prevents infinite loops via a resolving guard flag.
+ */
+export declare function resolveSymbol(name: string, table: SymbolTable): string | undefined;
+//# sourceMappingURL=symbolTable.d.ts.map

package/dist/src/coverage/deep-analysis/symbolTable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbolTable.d.ts","sourceRoot":"","sources":["../../../../src/coverage/deep-analysis/symbolTable.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAe,WAAW,EAAE,MAAM,SAAS,CAAC;AAIxD;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CA8CnE;AAID;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAoCrE;AAID;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAyCvE;AAID;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAmCvE;AAID;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,YAAY,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAClG,WAAW,CAcb;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAKlF"}

package/dist/src/coverage/deep-analysis/symbolTable.js

@@ -0,0 +1,230 @@
+"use strict";
+/**
+ * Deep Code Analysis — Symbol Table
+ *
+ * Extracts named symbols (constants, variables, enum members) from source
+ * file content across all supported languages and builds a per-file symbol
+ * table for downstream resolvers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSymbolTableFromJs = buildSymbolTableFromJs;
+exports.buildSymbolTableFromJava = buildSymbolTableFromJava;
+exports.buildSymbolTableFromKotlin = buildSymbolTableFromKotlin;
+exports.buildSymbolTableFromPython = buildSymbolTableFromPython;
+exports.buildSymbolTable = buildSymbolTable;
+exports.resolveSymbol = resolveSymbol;
+// ─── TypeScript / JavaScript ──────────────────────────────────────────────────
+/**
+ * Extract symbols from TypeScript/JavaScript source.
+ *
+ * Captures:
+ *   - const NAME = 'value'   (top-level and local)
+ *   - let NAME = 'value'
+ *   - var NAME = 'value'
+ *   - enum Foo { MEMBER = 'value' }  (string enums)
+ *   - const obj = { key: 'value' }  — top-level object property literals
+ */
+function buildSymbolTableFromJs(content) {
+    const table = new Map();
+    // Simple const/let/var assignments with a string literal value (allow empty strings)
+    const varPattern = /\b(const|let|var)\s+([A-Za-z_$][A-Za-z0-9_$]*)\s*=\s*['"`]([^'"`\n]*)['"`]/g;
+    let m;
+    while ((m = varPattern.exec(content)) !== null) {
+        const [, kind, name, value] = m;
+        table.set(name, {
+            name,
+            kind: kind === 'const' ? 'const' : kind === 'let' ? 'let' : 'var',
+            value,
+        });
+    }
+    // TypeScript string enum members: enum Routes { USERS = '/users' }
+    // Allow {param} segments inside enum body strings (e.g. "/users/{id}")
+    const enumPattern = /\benum\s+([A-Za-z_$][A-Za-z0-9_$]*)\s*\{((?:[^{}]|\{[^}]*\})*)\}/g;
+    while ((m = enumPattern.exec(content)) !== null) {
+        const enumName = m[1];
+        const body = m[2];
+        const memberPattern = /([A-Za-z_$][A-Za-z0-9_$]*)\s*=\s*['"`]([^'"`\n]+)['"`]/g;
+        let mm;
+        while ((mm = memberPattern.exec(body)) !== null) {
+            const [, member, value] = mm;
+            // Register as both Routes.USERS and bare USERS
+            table.set(`${enumName}.${member}`, { name: `${enumName}.${member}`, kind: 'enum', value });
+            table.set(member, { name: member, kind: 'enum', value });
+        }
+    }
+    // Object literal properties: const Paths = { USERS: '/users', ... }
+    const objPattern = /\b(?:const|let|var)\s+([A-Za-z_$][A-Za-z0-9_$]*)\s*=\s*\{([^}]+)\}/g;
+    while ((m = objPattern.exec(content)) !== null) {
+        const objName = m[1];
+        const body = m[2];
+        const propPattern = /([A-Za-z_$][A-Za-z0-9_$]*)\s*:\s*['"`]([^'"`\n]+)['"`]/g;
+        let mm;
+        while ((mm = propPattern.exec(body)) !== null) {
+            const [, prop, value] = mm;
+            table.set(`${objName}.${prop}`, { name: `${objName}.${prop}`, kind: 'property', value });
+            // Don't register bare property names to avoid collisions
+        }
+    }
+    return table;
+}
+// ─── Java ─────────────────────────────────────────────────────────────────────
+/**
+ * Extract symbols from Java source.
+ *
+ * Captures:
+ *   - static final String NAME = "value";
+ *   - final String NAME = "value";
+ *   - String NAME = "value";
+ *   - enum Routes { USERS("/users"), ... }  (constructor-style enums)
+ */
+function buildSymbolTableFromJava(content) {
+    const table = new Map();
+    // Static/final string constants
+    const constPattern = /(?:(?:private|public|protected|package)\s+)?(?:static\s+)?(?:final\s+)?String\s+([A-Z_][A-Z0-9_]*)\s*=\s*"([^"\\]*(?:\\.[^"\\]*)*)"/g;
+    let m;
+    while ((m = constPattern.exec(content)) !== null) {
+        table.set(m[1], { name: m[1], kind: 'const', value: m[2] });
+    }
+    // Camel-case constants too (e.g. private static final String basePath = "/api")
+    const camelPattern = /(?:(?:private|public|protected|package)\s+)?(?:static\s+)?(?:final\s+)?String\s+([a-z][A-Za-z0-9_]*)\s*=\s*"([^"\\]*(?:\\.[^"\\]*)*)"/g;
+    while ((m = camelPattern.exec(content)) !== null) {
+        if (!table.has(m[1])) {
+            table.set(m[1], { name: m[1], kind: 'const', value: m[2] });
+        }
+    }
+    // Enum constructor style: USERS("/users")
+    // Allow {param} segments inside enum body strings (e.g. "/users/{id}")
+    const enumBlock = /enum\s+([A-Za-z_][A-Za-z0-9_]*)\s*\{((?:[^{}]|\{[^}]*\})*)\}/g;
+    while ((m = enumBlock.exec(content)) !== null) {
+        const enumName = m[1];
+        const body = m[2];
+        const memberPattern = /([A-Z_][A-Z0-9_]*)\s*\(\s*"([^"]+)"/g;
+        let mm;
+        while ((mm = memberPattern.exec(body)) !== null) {
+            const [, member, value] = mm;
+            table.set(`${enumName}.${member}`, { name: `${enumName}.${member}`, kind: 'enum', value });
+            table.set(member, { name: member, kind: 'enum', value });
+        }
+    }
+    return table;
+}
+// ─── Kotlin ───────────────────────────────────────────────────────────────────
+/**
+ * Extract symbols from Kotlin source.
+ *
+ * Captures:
+ *   - const val NAME = "value"
+ *   - val NAME = "value"
+ *   - enum class Routes(val path: String) { USERS("/users"), ... }
+ *   - object Constants { const val NAME = "value" }
+ */
+function buildSymbolTableFromKotlin(content) {
+    const table = new Map();
+    // const val and val string assignments
+    const valPattern = /\b(?:const\s+)?val\s+([A-Za-z_][A-Za-z0-9_]*)\s*=\s*["']([^"'\n]+)["']/g;
+    let m;
+    while ((m = valPattern.exec(content)) !== null) {
+        table.set(m[1], { name: m[1], kind: 'const', value: m[2] });
+    }
+    // Kotlin enum class with constructor argument: USERS("/users")
+    const enumBlock = /enum\s+class\s+([A-Za-z_][A-Za-z0-9_]*)[^{]*\{([^}]+)\}/gs;
+    while ((m = enumBlock.exec(content)) !== null) {
+        const enumName = m[1];
+        const body = m[2];
+        const memberPattern = /([A-Z_][A-Z0-9_]*)\s*\(\s*["']([^"']+)["']/g;
+        let mm;
+        while ((mm = memberPattern.exec(body)) !== null) {
+            const [, member, value] = mm;
+            table.set(`${enumName}.${member}`, { name: `${enumName}.${member}`, kind: 'enum', value });
+            table.set(member, { name: member, kind: 'enum', value });
+        }
+    }
+    // Kotlin object/companion object property: object Routes { const val USERS = "/users" }
+    const objectBlock = /(?:companion\s+)?object\s+([A-Za-z_][A-Za-z0-9_]*)\s*\{([^}]+)\}/g;
+    while ((m = objectBlock.exec(content)) !== null) {
+        const objName = m[1];
+        const body = m[2];
+        const propPattern = /\b(?:const\s+)?val\s+([A-Za-z_][A-Za-z0-9_]*)\s*=\s*["']([^"'\n]+)["']/g;
+        let mm;
+        while ((mm = propPattern.exec(body)) !== null) {
+            const [, prop, value] = mm;
+            table.set(`${objName}.${prop}`, { name: `${objName}.${prop}`, kind: 'property', value });
+            if (!table.has(prop)) {
+                table.set(prop, { name: prop, kind: 'const', value });
+            }
+        }
+    }
+    return table;
+}
+// ─── Python ───────────────────────────────────────────────────────────────────
+/**
+ * Extract symbols from Python source.
+ *
+ * Captures:
+ *   - UPPER_CASE = "/path"   (module-level constants)
+ *   - class Routes(Enum): USERS = "/users"
+ */
+function buildSymbolTableFromPython(content) {
+    const table = new Map();
+    // Module-level UPPER_CASE constants
+    const constPattern = /^([A-Z_][A-Z0-9_]*)\s*=\s*['"]([^'"\n]+)['"]/gm;
+    let m;
+    while ((m = constPattern.exec(content)) !== null) {
+        table.set(m[1], { name: m[1], kind: 'const', value: m[2] });
+    }
+    // Also capture lower-case module-level string assignments
+    const lowerPattern = /^([a-z_][a-z0-9_]*)\s*=\s*['"]([^'"\n]+)['"]/gm;
+    while ((m = lowerPattern.exec(content)) !== null) {
+        if (!table.has(m[1])) {
+            table.set(m[1], { name: m[1], kind: 'let', value: m[2] });
+        }
+    }
+    // Enum class members: class Routes(Enum):\n    USERS = "/users"
+    // Note: no \s* after colon — the \n must be left for the body group to match
+    // Use [ \t]* (not \s*) for trailing whitespace to avoid consuming next line's \n
+    const enumBlock = /class\s+([A-Za-z_][A-Za-z0-9_]*)\s*\([^)]*Enum[^)]*\):((?:\n[ \t]+[A-Z_][A-Z0-9_]*\s*=\s*['"][^'"]+['"][ \t]*)+)/g;
+    while ((m = enumBlock.exec(content)) !== null) {
+        const enumName = m[1];
+        const body = m[2];
+        const memberPattern = /([A-Z_][A-Z0-9_]*)\s*=\s*['"]([^'"]+)['"]/g;
+        let mm;
+        while ((mm = memberPattern.exec(body)) !== null) {
+            const [, member, value] = mm;
+            table.set(`${enumName}.${member}`, { name: `${enumName}.${member}`, kind: 'enum', value });
+            table.set(member, { name: member, kind: 'enum', value });
+        }
+    }
+    return table;
+}
+// ─── Dispatcher ───────────────────────────────────────────────────────────────
+/**
+ * Build a symbol table from source content for the given language.
+ */
+function buildSymbolTable(content, language) {
+    switch (language) {
+        case 'java':
+            return buildSymbolTableFromJava(content);
+        case 'kotlin':
+            return buildSymbolTableFromKotlin(content);
+        case 'python':
+            return buildSymbolTableFromPython(content);
+        case 'typescript':
+        case 'javascript':
+        case 'auto':
+        default:
+            return buildSymbolTableFromJs(content);
+    }
+}
+/**
+ * Resolve a symbol name to its string value using the table.
+ * Returns undefined when the symbol is not found or has no static value.
+ * Prevents infinite loops via a resolving guard flag.
+ */
+function resolveSymbol(name, table) {
+    const entry = table.get(name);
+    if (!entry || entry.resolving)
+        return undefined;
+    if (entry.value !== undefined)
+        return entry.value;
+    return undefined;
+}

package/dist/src/coverage/deep-analysis/types.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Deep Code Analysis — Shared Types
+ *
+ * Types used across all deep-analysis sub-modules.
+ */
+/**
+ * How the HTTP call was resolved. 'direct' means a literal string was found
+ * in the call site; all other types represent an indirection that was resolved.
+ */
+export type ResolutionType = 'direct' | 'constant' | 'enum' | 'string-template' | 'interpolated-path' | 'wrapper-method' | 'request-builder' | 'client-mapping' | 'client-abstraction' | 'cucumber-step' | 'heuristic';
+/**
+ * The kind of assertion that was linked to an HTTP interaction.
+ */
+export type AssertionType = 'status-code' | 'body-field' | 'fluent-chain' | 'exception-catch' | 'none';
+export type ConfidenceLevel = 'high' | 'medium' | 'low';
+/**
+ * A fully or partially resolved HTTP call produced by the deep-analysis layer.
+ */
+export interface ResolvedHttpCall {
+    /** HTTP method in upper-case (GET, POST, …) */
+    method: string;
+    /** Raw path as resolved (may contain variables like /users/123) */
+    path: string;
+    /**
+     * Path normalized to an OpenAPI path template.
+     * e.g. /users/123 → /users/{id}
+     */
+    normalizedPath?: string;
+    /** Absolute path of the source file where the call was found */
+    sourceFile: string;
+    /** Language the call was found in */
+    sourceLanguage: string;
+    /** How the endpoint was resolved */
+    resolutionType: ResolutionType;
+    /** Confidence level of the resolution */
+    confidence: ConfidenceLevel;
+    /** Whether the call was followed by an assertion on the response */
+    assertionLinked?: boolean;
+    /** The type of assertion linked to this call, if any */
+    assertionType?: AssertionType;
+    /** The raw call text as it appeared in the source for debugging */
+    rawCall?: string;
+}
+export type SymbolKind = 'const' | 'let' | 'var' | 'enum' | 'parameter' | 'property' | 'function';
+/** A single symbol entry extracted from a source file */
+export interface SymbolEntry {
+    /** Symbol identifier name */
+    name: string;
+    /** Symbol declaration kind */
+    kind: SymbolKind;
+    /** Statically known string value, if any */
+    value?: string;
+    /** Guard against circular resolution */
+    resolving?: boolean;
+    /** Line number where the symbol is declared (1-based, if known) */
+    line?: number;
+}
+/** Per-file symbol lookup map */
+export type SymbolTable = Map<string, SymbolEntry>;
+/**
+ * A user-defined mapping from a domain-level client method call to an HTTP
+ * method + path template. Used to resolve calls like userClient.getById(id).
+ */
+export interface ClientMethodMapping {
+    /** The class or object name (e.g. 'userClient', 'PaymentsApi') */
+    classOrObject: string;
+    /** The method name (e.g. 'getById', 'createRefund') */
+    method: string;
+    /** HTTP method in upper-case (e.g. 'GET') */
+    httpMethod: string;
+    /** OpenAPI-style path template (e.g. '/users/{id}') */
+    pathTemplate: string;
+}
+/**
+ * Configuration for the deep-endpoint-analysis feature.
+ */
+export interface DeepAnalysisConfig {
+    /** Master switch. When false the engine falls back to direct regex only. */
+    enabled: boolean;
+    /** Maximum number of method-call levels to follow when tracing wrappers. */
+    maxCallDepth: number;
+    /** Resolve named constant/variable references to their literal values. */
+    resolveConstants: boolean;
+    /** Resolve enum member references to their literal path values. */
+    resolveEnums: boolean;
+    /** Resolve template literals and string concatenation. */
+    resolveStringTemplates: boolean;
+    /** Trace helper/wrapper methods one or more levels to find HTTP calls. */
+    resolveWrappers: boolean;
+    /** Detect request-builder / request-object patterns. */
+    resolveRequestBuilders: boolean;
+    /** Apply explicit or inferred client-to-HTTP-method mapping. */
+    resolveClientMappings: boolean;
+    /** Associate HTTP calls with downstream response assertions. */
+    assertionAware: boolean;
+    /** Explicit client-method → HTTP mappings (optional, user-supplied). */
+    clientMappings?: ClientMethodMapping[];
+}
+/** Default deep-analysis configuration (enabled, all features on). */
+export declare const DEFAULT_DEEP_ANALYSIS_CONFIG: DeepAnalysisConfig;
+/**
+ * A node in the per-file call graph.
+ * Represents one function/method defined in the same file.
+ */
+export interface CallGraphNode {
+    /** Function/method name */
+    name: string;
+    /** Raw body text of the function */
+    body: string;
+    /** Names of other local functions this one calls */
+    calls: string[];
+    /** HTTP calls found directly in this function body (before wrapper resolution) */
+    directHttpCalls: Array<{
+        method: string;
+        path: string;
+    }>;
+    /** The static return value if the function just returns a string literal */
+    returnValue?: string;
+}
+/** Per-file call graph */
+export type CallGraph = Map<string, CallGraphNode>;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/coverage/deep-analysis/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/coverage/deep-analysis/types.ts"],"names":[],"mappings":"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"}

package/dist/src/coverage/deep-analysis/types.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Deep Code Analysis — Shared Types
+ *
+ * Types used across all deep-analysis sub-modules.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_DEEP_ANALYSIS_CONFIG = void 0;
+/** Default deep-analysis configuration (enabled, all features on). */
+exports.DEFAULT_DEEP_ANALYSIS_CONFIG = {
+    enabled: true,
+    maxCallDepth: 4,
+    resolveConstants: true,
+    resolveEnums: true,
+    resolveStringTemplates: true,
+    resolveWrappers: true,
+    resolveRequestBuilders: true,
+    resolveClientMappings: true,
+    assertionAware: true,
+    clientMappings: [],
+};