cgraphx 1.2.0 → 1.3.0

package/dist/api-test/bru-cli-invoker.js

@@ -0,0 +1,169 @@
+"use strict";
+/**
+ * Bruno CLI subprocess invoker — isolated in its own module so tests can
+ * `vi.spyOn` the `invokeBrunoCli` export and intercept calls from
+ * `bru-runner.ts`.
+ *
+ * Why a separate module: same reason as `db-query-cli.ts` — when the
+ * subprocess call lives in the same module as its caller, vitest's
+ * `vi.spyOn(module, 'fn')` cannot intercept the internal bare-local-binding
+ * call. Cross-module imports route through the namespace, which the spy CAN
+ * replace.
+ *
+ * Independent subsystem — does NOT import from `src/extraction/` /
+ * `src/resolution/` / `src/db/`. The Bruno CLI is invoked as a subprocess
+ * (spec §12 isolation).
+ */
+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_CLI_INVOKER = void 0;
+exports.invokeBrunoCli = invokeBrunoCli;
+exports.detectBrunoCli = detectBrunoCli;
+exports.resolveCollectionDir = resolveCollectionDir;
+const node_child_process_1 = require("node:child_process");
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+/**
+ * Invoke `npx @usebruno/cli` with the given args. Returns the captured
+ * stdout/stderr/exitCode. The caller is responsible for arg construction
+ * (see `bru-runner.ts`).
+ *
+ * Exported so tests can `vi.spyOn(bruCliInvoker, 'invokeBrunoCli')` instead
+ * of spawning a real subprocess / real Bruno CLI.
+ */
+function invokeBrunoCli(args, options) {
+    const maxBuffer = options.maxBuffer ?? 10 * 1024 * 1024;
+    try {
+        const result = (0, node_child_process_1.spawnSync)(process.execPath, args, {
+            cwd: options.cwd,
+            encoding: 'utf8',
+            timeout: options.timeoutMs,
+            maxBuffer,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        return {
+            stdout: typeof result.stdout === 'string' ? result.stdout : '',
+            stderr: typeof result.stderr === 'string' ? result.stderr : '',
+            exitCode: result.status,
+            timedOut: result.signal === 'SIGTERM' || (result.signal != null && result.signal !== null),
+        };
+    }
+    catch (err) {
+        // spawnSync throws on ENOENT (node binary not found — shouldn't happen)
+        // or other spawn-level failures. Normalize to a non-zero exit.
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            stdout: '',
+            stderr: `spawn failed: ${msg}`,
+            exitCode: 1,
+            timedOut: false,
+        };
+    }
+}
+/**
+ * Probe whether the Bruno CLI is available. Tries, in order:
+ *   1. `npx @usebruno/cli --version` (preferred — always works if npm cache
+ *      has the package, even without global install).
+ *   2. Global `bru` command (`which bru`).
+ *   3. Global `bruno` command (`which bruno`).
+ *
+ * Returns the resolved command + base args for subsequent `invokeBrunoCli`
+ * calls, or `null` when no Bruno CLI is reachable.
+ *
+ * Exported so tests can spy on it to simulate "Bruno CLI unavailable".
+ */
+function detectBrunoCli() {
+    // 1. npx @usebruno/cli --version (short timeout — npx may need to fetch).
+    const probe = (0, node_child_process_1.spawnSync)(process.execPath, ['@usebruno/cli', '--version'], {
+        encoding: 'utf8',
+        timeout: 30_000,
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    if (probe.status === 0 && probe.stdout.trim().length > 0) {
+        return { command: process.execPath, baseArgs: ['@usebruno/cli'] };
+    }
+    // npx wraps @usebruno/cli; the direct `node @usebruno/cli` form above only
+    // resolves when the package is installed locally. Use `npx` explicitly so
+    // the package is fetched on demand.
+    const npxProbe = (0, node_child_process_1.spawnSync)('npx', ['@usebruno/cli', '--version'], {
+        encoding: 'utf8',
+        timeout: 30_000,
+        stdio: ['ignore', 'pipe', 'pipe'],
+        shell: process.platform === 'win32',
+    });
+    if (npxProbe.status === 0 && npxProbe.stdout.trim().length > 0) {
+        return { command: 'npx', baseArgs: ['@usebruno/cli'] };
+    }
+    // 2. Global `bru` command.
+    const bruProbe = (0, node_child_process_1.spawnSync)('bru', ['--version'], {
+        encoding: 'utf8',
+        timeout: 5_000,
+        stdio: ['ignore', 'pipe', 'pipe'],
+        shell: process.platform === 'win32',
+    });
+    if (bruProbe.status === 0 && bruProbe.stdout.trim().length > 0) {
+        return { command: 'bru', baseArgs: [] };
+    }
+    // 3. Global `bruno` command.
+    const brunoProbe = (0, node_child_process_1.spawnSync)('bruno', ['--version'], {
+        encoding: 'utf8',
+        timeout: 5_000,
+        stdio: ['ignore', 'pipe', 'pipe'],
+        shell: process.platform === 'win32',
+    });
+    if (brunoProbe.status === 0 && brunoProbe.stdout.trim().length > 0) {
+        return { command: 'bruno', baseArgs: [] };
+    }
+    return null;
+}
+/**
+ * Resolve the collection directory. If `filter.service` is set, narrow to
+ * `<collectionDir>/<service>/` when it exists; otherwise fall back to the
+ * whole collection dir (Bruno CLI will just find no matching requests).
+ */
+function resolveCollectionDir(collectionDir, filter) {
+    if (filter?.service) {
+        const sub = path.join(collectionDir, filter.service);
+        if (fs.existsSync(sub) && fs.statSync(sub).isDirectory()) {
+            return sub;
+        }
+    }
+    return collectionDir;
+}
+/** Internal helper re-exported for tests. */
+exports.__INTERNAL_BRU_CLI_INVOKER = {
+    resolveCollectionDir,
+};
+//# sourceMappingURL=bru-cli-invoker.js.map

package/dist/api-test/bru-cli-invoker.js.map

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

package/dist/api-test/bru-report-parser.d.ts

@@ -0,0 +1,24 @@
+/**
+ * L-T-30: bru-report-parser — parse `bru run --output results.json --format json` output.
+ *
+ * Bruno CLI report schema (from L-T-00 exploration of bruno source code):
+ *   { results: [ { name, suitename, path, runDuration, response: { status, body, ... },
+ *                  testResults, assertionResults, error, skipped } ] }
+ *
+ * Robust parser — supports field aliases across Bruno CLI versions.
+ */
+export interface BruReportEntry {
+    endpoint: string;
+    httpStatus: number;
+    responseBody: string;
+    tests: unknown[];
+    durationMs: number;
+    error: string | null;
+}
+/**
+ * Parse a bru run JSON report and extract the entry matching `endpoint`.
+ * `endpoint` matches against `name` (preferred) or `path` stem.
+ * Returns null if no match found.
+ */
+export declare function parseBruReport(reportJson: string, endpoint: string): BruReportEntry | null;
+//# sourceMappingURL=bru-report-parser.d.ts.map

package/dist/api-test/bru-report-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bru-report-parser.d.ts","sourceRoot":"","sources":["../../src/api-test/bru-report-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAe1F"}

package/dist/api-test/bru-report-parser.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * L-T-30: bru-report-parser — parse `bru run --output results.json --format json` output.
+ *
+ * Bruno CLI report schema (from L-T-00 exploration of bruno source code):
+ *   { results: [ { name, suitename, path, runDuration, response: { status, body, ... },
+ *                  testResults, assertionResults, error, skipped } ] }
+ *
+ * Robust parser — supports field aliases across Bruno CLI versions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseBruReport = parseBruReport;
+/**
+ * Parse a bru run JSON report and extract the entry matching `endpoint`.
+ * `endpoint` matches against `name` (preferred) or `path` stem.
+ * Returns null if no match found.
+ */
+function parseBruReport(reportJson, endpoint) {
+    let parsed;
+    try {
+        parsed = JSON.parse(reportJson);
+    }
+    catch {
+        return null;
+    }
+    const results = extractResultsArray(parsed);
+    if (!results || results.length === 0)
+        return null;
+    const match = results.find((r) => matchesEndpoint(r, endpoint));
+    if (!match)
+        return null;
+    return extractEntry(match, endpoint);
+}
+function extractResultsArray(parsed) {
+    // Bruno CLI actual output: [{ iterationIndex: 0, results: [{ test, request, response, ... }] }]
+    // Unwrap iterations and flatten all `results` arrays.
+    if (Array.isArray(parsed)) {
+        const flat = [];
+        for (const item of parsed) {
+            if (item && typeof item === 'object') {
+                const obj = item;
+                if (Array.isArray(obj.results)) {
+                    flat.push(...obj.results);
+                }
+                else if (Array.isArray(obj.tests)) {
+                    flat.push(...obj.tests);
+                }
+                else {
+                    // Already an entry (no wrapper)
+                    flat.push(item);
+                }
+            }
+        }
+        return flat.length > 0 ? flat : parsed;
+    }
+    if (parsed && typeof parsed === 'object') {
+        const obj = parsed;
+        if (Array.isArray(obj.results))
+            return obj.results;
+        if (Array.isArray(obj.tests))
+            return obj.tests;
+    }
+    return null;
+}
+function matchesEndpoint(entry, endpoint) {
+    if (!entry || typeof entry !== 'object')
+        return false;
+    const obj = entry;
+    const name = obj.name ?? obj.request?.name;
+    if (typeof name === 'string' && name === endpoint)
+        return true;
+    const entryPath = obj.path ?? obj.test?.filename;
+    if (typeof entryPath === 'string') {
+        const stem = entryPath.replace(/\.bru$/, '').split('/').pop();
+        if (stem === endpoint)
+            return true;
+    }
+    return false;
+}
+function extractEntry(entry, endpoint) {
+    const obj = (entry && typeof entry === 'object' ? entry : {});
+    const response = (obj.response ?? {});
+    const httpStatus = (typeof response.status === 'number' ? response.status : null) ??
+        (typeof response.statusCode === 'number' ? response.statusCode : null) ??
+        (typeof obj.status === 'number' ? obj.status : 0);
+    // Bruno CLI stores response body in `response.data` (object or string), not `response.body`.
+    const responseData = response.data ?? response.body ?? obj.responseBody;
+    const responseBody = typeof responseData === 'string' ? responseData :
+        (responseData && typeof responseData === 'object' ? JSON.stringify(responseData) : '');
+    const tests = Array.isArray(obj.testResults) ? obj.testResults :
+        Array.isArray(obj.tests) ? obj.tests :
+            Array.isArray(obj.assertionResults) ? obj.assertionResults :
+                [];
+    const runDuration = (typeof obj.runDuration === 'number' ? obj.runDuration : null) ??
+        (typeof obj.duration === 'number' ? obj.duration : 0);
+    const durationMs = Math.round(runDuration * 1000);
+    const error = (typeof obj.error === 'string' ? obj.error : null) ??
+        (obj.error && typeof obj.error === 'object' && typeof obj.error.message === 'string'
+            ? obj.error.message
+            : null);
+    return {
+        endpoint,
+        httpStatus,
+        responseBody,
+        tests,
+        durationMs,
+        error,
+    };
+}
+//# sourceMappingURL=bru-report-parser.js.map

package/dist/api-test/bru-report-parser.js.map

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

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

@@ -0,0 +1,101 @@
+/**
+ * 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).
+ */
+import type { ApiTestProfile } from './types';
+import { type BrunoCliInvocation } from './bru-cli-invoker';
+/** Result of running one endpoint through Bruno CLI. */
+export interface BrunoRunResult {
+    /** Endpoint name — matches the `.bru` `meta.name` (i.e. `<svc_id>_<method>`). */
+    endpoint: string;
+    /** HTTP status code returned by the server. 0 when the request never completed. */
+    httpStatus: number;
+    /** Raw response body string (for biz-code extraction by the CLI layer). */
+    responseBody: string;
+    /** Request duration in milliseconds. */
+    durationMs: number;
+    /** Error tag when the request didn't succeed. `null` on a clean 2xx. */
+    error: string | null;
+}
+/**
+ * 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.
+ */
+export declare function runBrunoCollection(collectionDir: string, profile: ApiTestProfile, filter?: {
+    service?: string;
+}): Promise<BrunoRunResult[]>;
+/**
+ * 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.
+ */
+declare function buildBrunoArgs(baseArgs: string[], collectionDir: string, profile: ApiTestProfile): string[];
+/**
+ * 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`.
+ */
+declare function parseBrunoOutput(invocation: BrunoCliInvocation): BrunoRunResult[];
+/** Normalize one Bruno result record into a `BrunoRunResult`. */
+declare function normalizeResult(record: unknown): BrunoRunResult;
+/**
+ * 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`.
+ */
+declare function parseTextOutput(stdout: string, timedOut: boolean): BrunoRunResult[];
+/** Internal helpers re-exported for tests. */
+export declare const __INTERNAL_BRU_RUNNER: {
+    buildBrunoArgs: typeof buildBrunoArgs;
+    parseBrunoOutput: typeof parseBrunoOutput;
+    parseTextOutput: typeof parseTextOutput;
+    normalizeResult: typeof normalizeResult;
+    PER_REQUEST_TIMEOUT_MS: number;
+};
+export { invokeBrunoCli, detectBrunoCli, resolveCollectionDir } from './bru-cli-invoker';
+export type { BrunoCliInvocation, InvokeBrunoCliOptions } from './bru-cli-invoker';
+//# sourceMappingURL=bru-runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bru-runner.d.ts","sourceRoot":"","sources":["../../src/api-test/bru-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAO3B,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,UAAU,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,YAAY,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5B,OAAO,CAAC,cAAc,EAAE,CAAC,CAsB3B;AAED;;;;;;;;;GASG;AACH,iBAAS,cAAc,CACrB,QAAQ,EAAE,MAAM,EAAE,EAClB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,cAAc,GACtB,MAAM,EAAE,CAgBV;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,iBAAS,gBAAgB,CAAC,UAAU,EAAE,kBAAkB,GAAG,cAAc,EAAE,CA2D1E;AAeD,iEAAiE;AACjE,iBAAS,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,cAAc,CA6BxD;AAgCD;;;;;;;;;GASG;AACH,iBAAS,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,cAAc,EAAE,CAuD5E;AAED,8CAA8C;AAC9C,eAAO,MAAM,qBAAqB;;;;;;CAMjC,CAAC;AAGF,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzF,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC"}