cgraphx 1.2.0 → 1.3.0

package/dist/api-test/bru-runner.js

@@ -0,0 +1,316 @@
+"use strict";
+/**
+ * Bruno runner — Phase 5 of the api-test pipeline.
+ *
+ * Spec contract (T-50):
+ *   - Invoke `npx @usebruno/cli run <collection-dir>` to fire every assembled
+ *     `.bru` request against the live target.
+ *   - Pass `--env <profile.env>` and `--var key=value` for each
+ *     `profile.variables` entry.
+ *   - Single-request timeout 30s; failure does not retry; serial execution
+ *     (MVP — no `--concurrent`).
+ *   - Parse Bruno CLI's JSON output into one `BrunoRunResult` per request.
+ *   - Bruno CLI unavailable → throw `BrunoCliError`; the CLI layer turns
+ *     that into exit code 4 + an install hint on stderr.
+ *
+ * Independent subsystem — does NOT import from `src/extraction/` /
+ * `src/resolution/` / `src/db/`. The Bruno CLI is invoked as a subprocess
+ * via `./bru-cli-invoker.ts` (subsystem isolation per spec §12).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveCollectionDir = exports.detectBrunoCli = exports.invokeBrunoCli = exports.__INTERNAL_BRU_RUNNER = void 0;
+exports.runBrunoCollection = runBrunoCollection;
+const errors_1 = require("./errors");
+const bru_cli_invoker_1 = require("./bru-cli-invoker");
+/** Per-request timeout: 30s (spec). */
+const PER_REQUEST_TIMEOUT_MS = 30_000;
+/** Hard cap for the whole collection run so a runaway doesn't hang CI. */
+const COLLECTION_TIMEOUT_CAP_MS = 10 * 60 * 1000;
+/**
+ * Run every `.bru` request in `collectionDir` against the live target.
+ *
+ * `filter.service` narrows the run to `<collectionDir>/<service>/` when that
+ * subdir exists.
+ *
+ * Throws `BrunoCliError` when the Bruno CLI cannot be reached — the CLI
+ * layer catches that and surfaces exit code 4 + an install hint.
+ */
+async function runBrunoCollection(collectionDir, profile, filter) {
+    const detected = (0, bru_cli_invoker_1.detectBrunoCli)();
+    if (detected === null) {
+        throw new errors_1.BrunoCliError('Bruno CLI 不可用。请安装:npm install -g @usebruno/cli\n或在仓库内:npm install @usebruno/cli --save-dev');
+    }
+    const targetDir = (0, bru_cli_invoker_1.resolveCollectionDir)(collectionDir, filter);
+    const args = buildBrunoArgs(detected.baseArgs, targetDir, profile);
+    // Per-request timeout × a generous multiplier for the whole collection.
+    // Bruno CLI runs requests serially by default, so N requests × 30s is the
+    // upper bound. Cap at COLLECTION_TIMEOUT_CAP_MS to avoid runaway hangs.
+    const timeoutMs = Math.min(PER_REQUEST_TIMEOUT_MS * 50, // assume ≤50 requests for the multiplier
+    COLLECTION_TIMEOUT_CAP_MS);
+    const invocation = (0, bru_cli_invoker_1.invokeBrunoCli)(args, { cwd: collectionDir, timeoutMs });
+    return parseBrunoOutput(invocation);
+}
+/**
+ * Build the full argv for `npx @usebruno/cli run <dir> --env ... --var ...`.
+ *
+ * Uses `--output json` (Bruno CLI ≥1.x supports this; the flag was renamed
+ * to `--format json` in some versions — `parseBrunoOutput` handles both
+ * shapes, and we pass both flags defensively when Bruno CLI accepts them).
+ *
+ * `profile.variables` entries are passed as `--var key=value` so Bruno's
+ * `{{var}}` template syntax resolves them at request time.
+ */
+function buildBrunoArgs(baseArgs, collectionDir, profile) {
+    const args = [...baseArgs, 'run', collectionDir];
+    if (profile.env) {
+        args.push('--env', profile.env);
+    }
+    // Pass baseUrl + variables as --var key=value so Bruno's {{var}} resolution
+    // picks them up. baseUrl is special-cased because the .bru url uses
+    // {{baseUrl}}.
+    args.push('--var', `baseUrl=${profile.baseUrl}`);
+    for (const [k, v] of Object.entries(profile.variables ?? {})) {
+        args.push('--var', `${k}=${v}`);
+    }
+    // Request both flag spellings — Bruno CLI ignores unknown flags in most
+    // versions, and the parser handles whichever shape actually comes back.
+    args.push('--output', 'json');
+    return args;
+}
+/**
+ * Parse Bruno CLI's output into per-request `BrunoRunResult`s.
+ *
+ * Bruno CLI's JSON output shape varies across versions. This parser handles
+ * the known shapes:
+ *   - JSON array: `[{ name, status, response, duration, error }, ...]`
+ *   - JSON object with `results` array: `{ results: [...] }`
+ *   - JSON object with `tests` array: `{ tests: [...] }`
+ *
+ * Field name aliases covered (best-effort):
+ *   - name: `name` | `request` | `testName` | `suite`
+ *   - status: `status` | `statusCode` | `responseStatus`
+ *   - body: `response` | `data` | `body` | `responseBody`
+ *   - duration: `duration` | `responseTime` | `elapsed`
+ *   - error: `error` | `errorMessage` | `err`
+ *
+ * When the output cannot be parsed as JSON, falls back to a text-scan that
+ * extracts `(\\d+)\\s+ms` + status codes — best-effort, marks unparseable
+ * requests with `error: bruno_output_parse_failed`.
+ */
+function parseBrunoOutput(invocation) {
+    const { stdout, stderr, exitCode, timedOut } = invocation;
+    // Bruno CLI writes JSON to stdout. If stdout is empty but the process
+    // failed, surface the stderr as a single error result.
+    const trimmed = stdout.trim();
+    if (trimmed.length === 0) {
+        if (timedOut) {
+            return [{
+                    endpoint: '(collection)',
+                    httpStatus: 0,
+                    responseBody: '',
+                    durationMs: 0,
+                    error: 'timeout',
+                }];
+        }
+        if (exitCode !== 0) {
+            return [{
+                    endpoint: '(collection)',
+                    httpStatus: 0,
+                    responseBody: '',
+                    durationMs: 0,
+                    error: stderr.trim().length > 0 ? `bruno_cli_failed: ${stderr.trim().slice(0, 200)}` : 'bruno_cli_failed',
+                }];
+        }
+        return [];
+    }
+    // Try JSON parse.
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        // Not JSON — fall back to text scan.
+        return parseTextOutput(trimmed, timedOut);
+    }
+    const records = extractResultArray(parsed);
+    if (records.length === 0) {
+        // JSON parsed but no recognizable results array — mark as parse failure.
+        if (timedOut) {
+            return [{
+                    endpoint: '(collection)',
+                    httpStatus: 0,
+                    responseBody: '',
+                    durationMs: 0,
+                    error: 'timeout',
+                }];
+        }
+        return [{
+                endpoint: '(collection)',
+                httpStatus: 0,
+                responseBody: trimmed,
+                durationMs: 0,
+                error: 'bruno_output_parse_failed',
+            }];
+    }
+    return records.map((r) => normalizeResult(r));
+}
+/** Pull the results array out of whichever top-level shape Bruno used. */
+function extractResultArray(parsed) {
+    if (Array.isArray(parsed))
+        return parsed;
+    if (parsed && typeof parsed === 'object') {
+        const obj = parsed;
+        for (const key of ['results', 'tests', 'requests', 'items']) {
+            const v = obj[key];
+            if (Array.isArray(v))
+                return v;
+        }
+    }
+    return [];
+}
+/** Normalize one Bruno result record into a `BrunoRunResult`. */
+function normalizeResult(record) {
+    const r = (record ?? {});
+    const endpoint = pickString(r, ['name', 'request', 'testName', 'suite']) ?? '(unknown)';
+    const httpStatus = pickNumber(r, ['status', 'statusCode', 'responseStatus']) ?? 0;
+    const responseBody = pickString(r, ['response', 'data', 'body', 'responseBody']) ?? '';
+    const durationMs = pickNumber(r, ['duration', 'responseTime', 'elapsed']) ?? 0;
+    const error = pickString(r, ['error', 'errorMessage', 'err']);
+    // Bruno CLI may report a per-request error (e.g. timeout) in the `error`
+    // field. Normalize common error strings to our tags.
+    let errorTag = null;
+    if (typeof error === 'string' && error.length > 0) {
+        const lower = error.toLowerCase();
+        if (lower.includes('timeout') || lower.includes('timed out')) {
+            errorTag = 'timeout';
+        }
+        else {
+            errorTag = `bruno_request_error: ${error.slice(0, 200)}`;
+        }
+    }
+    else if (httpStatus === 0) {
+        errorTag = 'bruno_request_failed';
+    }
+    return {
+        endpoint,
+        httpStatus,
+        responseBody,
+        durationMs,
+        error: errorTag,
+    };
+}
+function pickString(r, keys) {
+    for (const k of keys) {
+        const v = r[k];
+        if (typeof v === 'string' && v.length > 0)
+            return v;
+        if (v != null && typeof v === 'object') {
+            // Response body may be a nested object — stringify it so the CLI layer
+            // can extract biz_code via JSON.parse.
+            try {
+                const s = JSON.stringify(v);
+                if (s && s.length > 0)
+                    return s;
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+    return undefined;
+}
+function pickNumber(r, keys) {
+    for (const k of keys) {
+        const v = r[k];
+        if (typeof v === 'number' && Number.isFinite(v))
+            return v;
+        if (typeof v === 'string') {
+            const n = Number(v);
+            if (Number.isFinite(n))
+                return n;
+        }
+    }
+    return undefined;
+}
+/**
+ * Best-effort text fallback parser. Bruno CLI's text output looks like:
+ *   ```
+ *   Running request: qryOrderList
+ *   Status: 200, Duration: 234ms
+ *   Response: {"code":"0"}
+ *   ```
+ * This parser extracts endpoint names + status + duration heuristically.
+ * Unparseable lines get `error: bruno_output_parse_failed`.
+ */
+function parseTextOutput(stdout, timedOut) {
+    const results = [];
+    const lines = stdout.split(/\r?\n/);
+    let current = null;
+    for (const line of lines) {
+        const nameMatch = /(?:Running request:|Request:)\s*(\S+)/.exec(line);
+        if (nameMatch) {
+            if (current)
+                results.push(current);
+            current = {
+                endpoint: nameMatch[1] ?? '(unknown)',
+                httpStatus: 0,
+                responseBody: '',
+                durationMs: 0,
+                error: null,
+            };
+            continue;
+        }
+        if (!current)
+            continue;
+        const statusMatch = /Status:\s*(\d+)/.exec(line);
+        if (statusMatch) {
+            current.httpStatus = Number(statusMatch[1] ?? 0);
+            continue;
+        }
+        const durMatch = /Duration:\s*(\d+)/.exec(line) || /(\d+)\s*ms/.exec(line);
+        if (durMatch) {
+            current.durationMs = Number(durMatch[1] ?? 0);
+            continue;
+        }
+        const respMatch = /Response:\s*(.*)/.exec(line);
+        if (respMatch) {
+            current.responseBody = respMatch[1] ?? '';
+            continue;
+        }
+    }
+    if (current)
+        results.push(current);
+    if (results.length === 0) {
+        if (timedOut) {
+            return [{
+                    endpoint: '(collection)',
+                    httpStatus: 0,
+                    responseBody: '',
+                    durationMs: 0,
+                    error: 'timeout',
+                }];
+        }
+        return [{
+                endpoint: '(collection)',
+                httpStatus: 0,
+                responseBody: stdout,
+                durationMs: 0,
+                error: 'bruno_output_parse_failed',
+            }];
+    }
+    return results;
+}
+/** Internal helpers re-exported for tests. */
+exports.__INTERNAL_BRU_RUNNER = {
+    buildBrunoArgs,
+    parseBrunoOutput,
+    parseTextOutput,
+    normalizeResult,
+    PER_REQUEST_TIMEOUT_MS,
+};
+// Re-export the invoker surface so callers can import everything from one place.
+var bru_cli_invoker_2 = require("./bru-cli-invoker");
+Object.defineProperty(exports, "invokeBrunoCli", { enumerable: true, get: function () { return bru_cli_invoker_2.invokeBrunoCli; } });
+Object.defineProperty(exports, "detectBrunoCli", { enumerable: true, get: function () { return bru_cli_invoker_2.detectBrunoCli; } });
+Object.defineProperty(exports, "resolveCollectionDir", { enumerable: true, get: function () { return bru_cli_invoker_2.resolveCollectionDir; } });
+//# sourceMappingURL=bru-runner.js.map

package/dist/api-test/bru-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bru-runner.js","sourceRoot":"","sources":["../../src/api-test/bru-runner.ts"],"names":[],"mappings":"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"}

package/dist/api-test/bru-writer.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Bruno `.bru` file writer.
+ *
+ * Spec §5.2 template — emits one `.bru` per endpoint. The HTTP method block
+ * keyword (`post {` / `get {` / `put {` / `delete {` / `patch {`) reflects
+ * `endpoint.httpMethod` (lowercased). Default body is `[{}]` — the assemble
+ * phase (T-40) fills it in; scan phase writes the placeholder.
+ *
+ * Header values from `config.defaultHeaders` are written verbatim, INCLUDING
+ * any `{{var}}` placeholders — Bruno resolves those at request time from the
+ * collection environment. Per spec §9, scan/analyze/assemble do NOT load the
+ * profile (only run does) — Bruno's `{{var}}` syntax does the substitution
+ * natively at request time.
+ *
+ * Public surface:
+ *   - `renderBru(endpoint, config)` — string
+ *   - `writeBru(endpoint, config, outputDir)` — Promise<string> (written path)
+ */
+import type { ApiTestConfig, Endpoint } from './types';
+/** Filename for an endpoint's `.bru` pair: `<svc_id>_<methodName>.bru`. */
+export declare function bruFileName(endpoint: Endpoint): string;
+/** Subdirectory under `outputDir` for an endpoint's service: `<service>/`. */
+export declare function serviceDirName(endpoint: Endpoint): string;
+/**
+ * Render the `.bru` body for one endpoint, following spec §5.2.
+ *
+ * The HTTP method keyword is derived from `endpoint.httpMethod`
+ * (lowercased). If the method is unknown (not get/post/put/delete/patch),
+ * fall back to `post` (the hx default) and emit a comment.
+ */
+export declare function renderBru(endpoint: Endpoint, config: ApiTestConfig): string;
+/**
+ * Write an endpoint's `.bru` to `<outputDir>/<service>/<svc_id>_<methodName>.bru`.
+ * Creates the service directory if needed. Returns the absolute written path.
+ *
+ * Also stamps the written path back onto `endpoint.bruPath` so the report
+ * phase can reference it.
+ */
+export declare function writeBru(endpoint: Endpoint, config: ApiTestConfig, outputDir: string): Promise<string>;
+/** Map an HTTP method string to Bruno's lowercase block key. `null` = unknown. */
+declare function normalizeHttpMethodKey(method: string): string | null;
+/** First non-empty line of a javadoc string, trimmed. */
+declare function firstLine(javadoc: string): string;
+/** Internal helpers re-exported for tests. */
+export declare const __INTERNAL_BRU: {
+    bruFileName: typeof bruFileName;
+    serviceDirName: typeof serviceDirName;
+    normalizeHttpMethodKey: typeof normalizeHttpMethodKey;
+    firstLine: typeof firstLine;
+};
+export {};
+//# sourceMappingURL=bru-writer.d.ts.map

package/dist/api-test/bru-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bru-writer.d.ts","sourceRoot":"","sources":["../../src/api-test/bru-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEvD,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAEtD;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAEzD;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,aAAa,GACpB,MAAM,CAqDR;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED,kFAAkF;AAClF,iBAAS,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM7D;AAED,yDAAyD;AACzD,iBAAS,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG1C;AAED,8CAA8C;AAC9C,eAAO,MAAM,cAAc;;;;;CAK1B,CAAC"}

package/dist/api-test/bru-writer.js

@@ -0,0 +1,159 @@
+"use strict";
+/**
+ * Bruno `.bru` file writer.
+ *
+ * Spec §5.2 template — emits one `.bru` per endpoint. The HTTP method block
+ * keyword (`post {` / `get {` / `put {` / `delete {` / `patch {`) reflects
+ * `endpoint.httpMethod` (lowercased). Default body is `[{}]` — the assemble
+ * phase (T-40) fills it in; scan phase writes the placeholder.
+ *
+ * Header values from `config.defaultHeaders` are written verbatim, INCLUDING
+ * any `{{var}}` placeholders — Bruno resolves those at request time from the
+ * collection environment. Per spec §9, scan/analyze/assemble do NOT load the
+ * profile (only run does) — Bruno's `{{var}}` syntax does the substitution
+ * natively at request time.
+ *
+ * Public surface:
+ *   - `renderBru(endpoint, config)` — string
+ *   - `writeBru(endpoint, config, outputDir)` — Promise<string> (written path)
+ */
+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.__INTERNAL_BRU = void 0;
+exports.bruFileName = bruFileName;
+exports.serviceDirName = serviceDirName;
+exports.renderBru = renderBru;
+exports.writeBru = writeBru;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+/** Filename for an endpoint's `.bru` pair: `<svc_id>_<methodName>.bru`. */
+function bruFileName(endpoint) {
+    return `${endpoint.svcId}_${endpoint.method}.bru`;
+}
+/** Subdirectory under `outputDir` for an endpoint's service: `<service>/`. */
+function serviceDirName(endpoint) {
+    return endpoint.service;
+}
+/**
+ * Render the `.bru` body for one endpoint, following spec §5.2.
+ *
+ * The HTTP method keyword is derived from `endpoint.httpMethod`
+ * (lowercased). If the method is unknown (not get/post/put/delete/patch),
+ * fall back to `post` (the hx default) and emit a comment.
+ */
+function renderBru(endpoint, config) {
+    const methodKey = normalizeHttpMethodKey(endpoint.httpMethod);
+    const metaName = `${endpoint.svcId}_${endpoint.method}`;
+    const url = endpoint.urlPattern;
+    const headerLines = Object.entries(config.defaultHeaders).map(([k, v]) => `    ${k}: ${v}`);
+    const headersBlock = headerLines.length > 0
+        ? `headers {\n${headerLines.join('\n')}\n}`
+        : 'headers {}';
+    const bodyTemplate = config.bodyTemplate || '[{}]';
+    const descLine = endpoint.javadoc
+        ? firstLine(endpoint.javadoc)
+        : '(scan 阶段未提取到 Javadoc,请补充业务说明)';
+    // The HTTP method block keyword — Bruno's grammar uses the lowercase method
+    // name as the block key. We emit the matched key; if the configured method
+    // is non-standard, fall back to `post` and add a `docs` note.
+    const methodBlockKey = methodKey ?? 'post';
+    const methodFallbackNote = methodKey === null
+        ? `\n    # NOTE: endpoint.httpMethod="${endpoint.httpMethod}" is non-standard; defaulting to post.`
+        : '';
+    return `meta {
+    name: ${metaName}
+    type: http
+}
+
+${methodBlockKey} {${methodFallbackNote}
+    url: ${url}
+    body: json
+}
+
+${headersBlock}
+
+body:json {
+    ${bodyTemplate}
+}
+
+docs {
+    业务说明: ${descLine}
+    完整分析见同名 .md 文件
+}
+
+tests {
+    test("HTTP 200", function() {
+        expect(res.getStatus()).to.equal(200);
+    });
+}
+`;
+}
+/**
+ * Write an endpoint's `.bru` to `<outputDir>/<service>/<svc_id>_<methodName>.bru`.
+ * Creates the service directory if needed. Returns the absolute written path.
+ *
+ * Also stamps the written path back onto `endpoint.bruPath` so the report
+ * phase can reference it.
+ */
+async function writeBru(endpoint, config, outputDir) {
+    const serviceDir = path.join(outputDir, serviceDirName(endpoint));
+    await fs.promises.mkdir(serviceDir, { recursive: true });
+    const filePath = path.join(serviceDir, bruFileName(endpoint));
+    const content = renderBru(endpoint, config);
+    await fs.promises.writeFile(filePath, content, 'utf8');
+    endpoint.bruPath = filePath;
+    return filePath;
+}
+/** Map an HTTP method string to Bruno's lowercase block key. `null` = unknown. */
+function normalizeHttpMethodKey(method) {
+    const m = method.trim().toLowerCase();
+    if (m === 'get' || m === 'post' || m === 'put' || m === 'delete' || m === 'patch') {
+        return m;
+    }
+    return null;
+}
+/** First non-empty line of a javadoc string, trimmed. */
+function firstLine(javadoc) {
+    const line = javadoc.split(/\r?\n/).map((s) => s.trim()).find((s) => s.length > 0);
+    return line ?? '';
+}
+/** Internal helpers re-exported for tests. */
+exports.__INTERNAL_BRU = {
+    bruFileName,
+    serviceDirName,
+    normalizeHttpMethodKey,
+    firstLine,
+};
+//# sourceMappingURL=bru-writer.js.map

package/dist/api-test/bru-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bru-writer.js","sourceRoot":"","sources":["../../src/api-test/bru-writer.ts"],"names":[],"mappings":"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"}

package/dist/api-test/call-chain-extractor.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Analyze phase — extract the call chain, dependency tables, and auth flag
+ * from an impl method body.
+ *
+ * Spec contract (T-30):
+ *   - Call chain: every `someService.method()` invocation in the body
+ *     (first-level callees only — no recursion into callees of callees).
+ *     At least 1 level is expected (impl → first callee).
+ *   - Dep tables: inferred from Mapper calls (`xxxMapper.selectXxx` etc.)
+ *     by stripping the `Mapper` suffix from the receiver's declared field
+ *     type (or receiver name) and lowercasing.
+ *   - Auth required: true when the impl calls `IAuthInfoService` (field type
+ *     or receiver name starting with `iAuth` / `IAuthInfoService`) or reads
+ *     the staffcode header (`ServerHeadersHolder.getStaffcode()` etc.).
+ *
+ * Implementation note: extraction uses `method.bodyText` (regex) rather than
+ * the AST `body` node. The T-11 parser deletes the tree after extraction to
+ * release WASM heap, which would invalidate any retained AST node reference;
+ * `bodyText` is captured before the delete and stays valid. The task's
+ * "允许局部适配" clause permits this regex-based approach.
+ *
+ * Self-contained: depends only on `./java-parser` (ClassInfo, MethodSignature).
+ * No imports from `src/extraction/` / `src/resolution/` / `src/db/`.
+ *
+ * Public surface:
+ *   - `extractCallChain(implInfo, method)` —
+ *       Promise<{ callChain: string[]; depTables: string[]; authRequired: boolean }>
+ */
+import type { ClassInfo, MethodSignature } from './java-parser';
+/**
+ * Extract `receiver.methodName` strings from the body text. Dedupes by
+ * the full `receiver.method` pair, preserving document order.
+ */
+declare function extractCallChainFromBody(bodyText: string): string[];
+/**
+ * Infer dependency table names from Mapper-typed calls in the body.
+ *
+ * Heuristic:
+ *   1. For each `xxxMapper.method()` call in the body, look up the field
+ *      `xxxMapper` on the impl class. If its type ends with `Mapper`,
+ *      strip the suffix and lowercase → table name.
+ *   2. Fallback: if the receiver name itself ends with `Mapper` (e.g.
+ *      `orderMapper`), strip + lowercase.
+ *
+ * Returns deduped table names in document order.
+ */
+declare function inferDepTables(bodyText: string, implInfo: ClassInfo): string[];
+/**
+ * Detect whether the impl method touches the auth surface.
+ *
+ * Signals (any one → true):
+ *   - The impl class has a field whose type simple-name is `IAuthInfoService`
+ *     (or whose name starts with `iAuth`).
+ *   - The body text references `IAuthInfoService`, `getStaffcode`, or
+ *     `ServerHeadersHolder`.
+ *
+ * The field-type check catches `@Resource IAuthInfoService iAuthService;`
+ * even when the body only calls `iAuthService.check()` (receiver name
+ * doesn't carry the type). The body-text check catches direct
+ * `ServerHeadersHolder.getStaffcode()` calls without a field.
+ */
+declare function detectAuthRequired(bodyText: string, implInfo: ClassInfo): boolean;
+/**
+ * Extract the call chain, dependency tables, and auth-required flag for
+ * one impl method. Returns empty arrays + `authRequired: false` when the
+ * method has no body (interface/abstract method — shouldn't happen for an
+ * impl, but defensive per T-11's empty-bodyText caveat).
+ */
+export declare function extractCallChain(implInfo: ClassInfo, method: MethodSignature): Promise<{
+    callChain: string[];
+    depTables: string[];
+    authRequired: boolean;
+}>;
+export declare const __INTERNAL_CALL_CHAIN: {
+    extractCallChainFromBody: typeof extractCallChainFromBody;
+    inferDepTables: typeof inferDepTables;
+    detectAuthRequired: typeof detectAuthRequired;
+};
+export {};
+//# sourceMappingURL=call-chain-extractor.d.ts.map

package/dist/api-test/call-chain-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-chain-extractor.d.ts","sourceRoot":"","sources":["../../src/api-test/call-chain-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAoBhE;;;GAGG;AACH,iBAAS,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAkB5D;AAMD;;;;;;;;;;;GAWG;AACH,iBAAS,cAAc,CACrB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,SAAS,GAClB,MAAM,EAAE,CA8BV;AAMD;;;;;;;;;;;;;GAaG;AACH,iBAAS,kBAAkB,CACzB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,SAAS,GAClB,OAAO,CAkBT;AAMD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,SAAS,EACnB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,CAAC,CAU9E;AAGD,eAAO,MAAM,qBAAqB;;;;CAIjC,CAAC"}