@opencodehub/ingestion 0.1.0

package/dist/extract/route-detector.js

@@ -0,0 +1,467 @@
+/**
+ * Route detectors.
+ *
+ * This file carries Next.js App Router (filesystem routing) and Express
+ * (app/router verb calls). Sibling files supply the other detectors:
+ *
+ *   - FastAPI / Starlette: route-detector-python.ts
+ *   - Spring MVC + WebFlux: route-detector-java.ts
+ *   - NestJS: route-detector-nestjs.ts
+ *   - Rails (`config/routes.rb`): route-detector-rails.ts
+ *
+ * All patterns below were authored fresh from the public framework
+ * documentation:
+ *   - Next.js App Router: https://nextjs.org/docs/app/building-your-application/routing
+ *   - Express routing:    https://expressjs.com/en/guide/routing.html
+ */
+import { resolveReceiver } from "./receiver-resolver.js";
+/**
+ * Module specifier the Express detector verifies receivers against. We
+ * accept only the canonical `"express"` specifier; wrapping libraries
+ * (`express-promise-router`, etc.) that rename `app`/`router` locally will
+ * land via their own `localAlias` so this tight match is safe.
+ */
+const EXPRESS_MODULE = "express";
+// ---------------------------------------------------------------------------
+// Next.js (App Router)
+// ---------------------------------------------------------------------------
+/** Files that are not routable themselves, even though they sit under `app/`. */
+const NEXTJS_SPECIAL_FILES = new Set([
+    "layout",
+    "error",
+    "loading",
+    "not-found",
+    "global-error",
+    "template",
+    "default",
+]);
+/** HTTP verbs that, when exported from a `route.ts`, become method handlers. */
+const NEXTJS_ROUTE_VERBS = ["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"];
+/** Match `export async function GET`, `export function POST`, `export const DELETE =`, etc. */
+const NEXTJS_VERB_EXPORT_RE = /export\s+(?:async\s+)?(?:function|const|let|var)\s+(GET|POST|PUT|DELETE|PATCH|HEAD|OPTIONS)\b/g;
+/**
+ * Convert one App-Router path segment to URL form:
+ *   - `(group)`        -> dropped (route groups, docs: "Route Groups")
+ *   - `[...slug]`      -> `{+slug}` (catch-all)
+ *   - `[[...slug]]`    -> `{+slug}` (optional catch-all; same shape at this layer)
+ *   - `[id]`           -> `{id}` (dynamic segment)
+ *   - anything else    -> passed through unchanged
+ */
+function nextJsSegmentToUrl(segment) {
+    if (segment.length === 0)
+        return null;
+    // Route groups: (foo) — invisible in URL.
+    if (segment.startsWith("(") && segment.endsWith(")"))
+        return null;
+    // Optional catch-all: [[...name]]
+    const optionalCatch = segment.match(/^\[\[\.\.\.(.+)\]\]$/);
+    if (optionalCatch)
+        return `{+${optionalCatch[1]}}`;
+    // Catch-all: [...name]
+    const catchAll = segment.match(/^\[\.\.\.(.+)\]$/);
+    if (catchAll)
+        return `{+${catchAll[1]}}`;
+    // Dynamic: [name]
+    const dynamic = segment.match(/^\[(.+)\]$/);
+    if (dynamic)
+        return `{${dynamic[1]}}`;
+    return segment;
+}
+/**
+ * Given a repo-relative file path, return the canonical URL under App Router,
+ * or `null` if the file is not a route. The input `filePath` is expected to
+ * be POSIX-style (forward slashes); on Windows callers should normalise.
+ */
+function nextJsUrlFromFilePath(filePath, repoRoot) {
+    const normalized = normalizeRelative(filePath, repoRoot);
+    const parts = normalized.split("/");
+    const appIndex = parts.indexOf("app");
+    if (appIndex === -1)
+        return null;
+    const under = parts.slice(appIndex + 1);
+    if (under.length === 0)
+        return null;
+    const last = under[under.length - 1];
+    if (last === undefined)
+        return null;
+    const match = last.match(/^(.+)\.(tsx?|jsx?|mjs|mts|cjs|cts)$/);
+    if (!match)
+        return null;
+    const basename = match[1];
+    // Only `route` and `page` map to URLs; layouts/error/loading/etc. are skipped.
+    if (basename !== "route" && basename !== "page")
+        return null;
+    if (NEXTJS_SPECIAL_FILES.has(basename))
+        return null;
+    const urlSegments = [];
+    for (const seg of under.slice(0, -1)) {
+        const converted = nextJsSegmentToUrl(seg);
+        if (converted === null)
+            continue;
+        urlSegments.push(converted);
+    }
+    return urlSegments.length === 0 ? "/" : `/${urlSegments.join("/")}`;
+}
+function normalizeRelative(filePath, repoRoot) {
+    const p = filePath.replace(/\\/g, "/");
+    const r = repoRoot.replace(/\\/g, "/").replace(/\/+$/, "");
+    if (r.length > 0 && p.startsWith(`${r}/`))
+        return p.slice(r.length + 1);
+    if (p.startsWith("/"))
+        return p.slice(1);
+    return p;
+}
+function extractNextJsVerbs(content) {
+    const verbs = new Set();
+    NEXTJS_VERB_EXPORT_RE.lastIndex = 0;
+    let match = NEXTJS_VERB_EXPORT_RE.exec(content);
+    while (match !== null) {
+        const verb = match[1];
+        if (verb !== undefined)
+            verbs.add(verb);
+        match = NEXTJS_VERB_EXPORT_RE.exec(content);
+    }
+    // Preserve canonical ordering instead of insertion order for byte-stability.
+    return NEXTJS_ROUTE_VERBS.filter((v) => verbs.has(v));
+}
+/**
+ * Walk the supplied files, filter to those under `app/**`, and emit one
+ * `ExtractedRoute` per route/method pair. `page.tsx` files emit a single
+ * route with no method (treated as an HTML GET page by consumers).
+ */
+export function detectNextJsRoutes(files, repoRoot) {
+    const out = [];
+    for (const file of files) {
+        const url = nextJsUrlFromFilePath(file.filePath, repoRoot);
+        if (url === null)
+            continue;
+        const rel = normalizeRelative(file.filePath, repoRoot);
+        const isRoute = /(^|\/)route\.(tsx?|jsx?|mjs|mts|cjs|cts)$/.test(rel);
+        if (isRoute) {
+            const verbs = extractNextJsVerbs(file.content);
+            if (verbs.length === 0) {
+                // A route.ts with no recognised verb export is still a route shell;
+                // surface it without a method so the pipeline can warn downstream.
+                out.push({ url, handlerFile: rel, framework: "nextjs" });
+            }
+            else {
+                for (const method of verbs) {
+                    out.push({ url, method, handlerFile: rel, framework: "nextjs" });
+                }
+            }
+        }
+        else {
+            // `page.tsx` — a renderable route; no HTTP method attached.
+            out.push({ url, handlerFile: rel, framework: "nextjs" });
+        }
+    }
+    return out;
+}
+// ---------------------------------------------------------------------------
+// Express
+// ---------------------------------------------------------------------------
+/**
+ * Match `app.get('/x', h)` / `router.post("/x", m, h)` / `server.use(\`/x\`, h)`.
+ *
+ * Group 1: receiver identifier (e.g. `app`, `router`, `apiRouter`).
+ * Group 2: HTTP verb keyword.
+ * Group 3: path — single-quoted, double-quoted, or template-literal body.
+ *
+ * Template-literal bodies are captured verbatim; callers inspect for `${...}`
+ * to decide whether to log a warning about unresolved interpolation.
+ */
+const EXPRESS_ROUTE_RE = /\b([A-Za-z_$][\w$]*)\s*\.\s*(get|post|put|delete|patch|all|use)\s*\(\s*(?:'([^']*)'|"([^"]*)"|`([^`]*)`)/g;
+const EXPRESS_VERBS = new Set([
+    "get",
+    "post",
+    "put",
+    "delete",
+    "patch",
+    "all",
+    "use",
+]);
+/**
+ * Regex-scan the file content for Express route registrations and emit one
+ * {@link ExtractedRoute} per (receiver, verb, path) triple whose receiver
+ * identifier resolves back to the `"express"` npm module. When no import
+ * map is supplied AND {@link ExtractInput.strictDetectors} is `false`, the
+ * detector falls back to the pre-P06 regex-only behavior so dogfood mode
+ * on legacy callers still produces edges.
+ */
+export function detectExpressRoutes(input) {
+    const { filePath, content, importsByFile, tsMorphProject, strictDetectors } = input;
+    const out = [];
+    EXPRESS_ROUTE_RE.lastIndex = 0;
+    let match = EXPRESS_ROUTE_RE.exec(content);
+    while (match !== null) {
+        const receiver = match[1] ?? "";
+        const verb = (match[2] ?? "").toLowerCase();
+        const pathSingle = match[3];
+        const pathDouble = match[4];
+        const pathTemplate = match[5];
+        const rawPath = pathSingle ?? pathDouble ?? pathTemplate;
+        const matchStart = match.index ?? 0;
+        const matchEnd = matchStart + match[0].length;
+        match = EXPRESS_ROUTE_RE.exec(content);
+        if (rawPath === undefined)
+            continue;
+        if (!EXPRESS_VERBS.has(verb))
+            continue;
+        if (pathTemplate !== undefined && /\$\{[^}]*\}/.test(pathTemplate)) {
+            // Template literal with interpolation; the URL cannot be resolved
+            // statically. Skip but leave a console warning so pipeline logs can
+            // surface it; consumers that want silent behaviour can wrap console.
+            // eslint-disable-next-line no-console
+            console.warn(`[extract/route-detector] express template literal with interpolation at ${filePath}: ${pathTemplate}`);
+            continue;
+        }
+        if (!confirmExpressReceiver(receiver, filePath, importsByFile, tsMorphProject, strictDetectors))
+            continue;
+        // Scrape the handler body for `res.json({...})` / `res.send({...})`
+        // object-literal shapes so downstream Route nodes can carry
+        // `responseKeys`. We scope the scan to the balanced-paren call that
+        // registered this route so neighbouring handlers don't bleed in.
+        const callBody = extractBalancedArgument(content, matchEnd);
+        const responseKeys = scrapeExpressResponseKeys(callBody);
+        out.push({
+            url: rawPath,
+            method: verb.toUpperCase(),
+            handlerFile: filePath,
+            framework: "express",
+            ...(responseKeys !== undefined ? { responseKeys } : {}),
+        });
+    }
+    return out;
+}
+/**
+ * Confirm `receiver` resolves to an `express` import in `filePath`. Returns
+ * `true` when:
+ *   - the import-graph or ts-morph path matches `"express"`, OR
+ *   - an import map is present, the receiver itself wasn't resolved, but
+ *     `"express"` is imported somewhere in the file (covers
+ *     `const app = express()` where `app` is a local const, not an
+ *     import) — unless strict mode is on, OR
+ *   - no import map was plumbed AND strict mode is off (legacy fallback).
+ *
+ * Returns `false` when:
+ *   - the receiver resolved to a DIFFERENT module (real false positive), OR
+ *   - an import map was plumbed, strict mode is on, and the receiver
+ *     isn't imported, OR
+ *   - an import map was plumbed, express is not imported anywhere in the
+ *     file, and the receiver itself isn't imported.
+ */
+function confirmExpressReceiver(receiver, filePath, importsByFile, tsMorphProject, strictDetectors) {
+    const origin = resolveReceiver(receiver, filePath, importsByFile, tsMorphProject);
+    if (origin !== null)
+        return origin.moduleName === EXPRESS_MODULE;
+    if (importsByFile !== undefined) {
+        if (strictDetectors)
+            return false;
+        const imports = importsByFile.get(filePath);
+        if (imports === undefined)
+            return false;
+        for (const imp of imports) {
+            if (imp.source === EXPRESS_MODULE)
+                return true;
+        }
+        return false;
+    }
+    return strictDetectors !== true;
+}
+// ---------------------------------------------------------------------------
+// Response-key scraping
+// ---------------------------------------------------------------------------
+/**
+ * Read from `startIdx` onward until the first balanced `)` closes. Returns
+ * the substring between the opening `(` and the matching `)`. When the
+ * starting region contains no opening paren (defensive) we return an empty
+ * string.
+ */
+function extractBalancedArgument(content, startIdx) {
+    let i = startIdx;
+    let depth = 0;
+    let seenOpen = false;
+    let bodyStart = -1;
+    while (i < content.length) {
+        const ch = content[i];
+        if (ch === "(") {
+            if (!seenOpen) {
+                seenOpen = true;
+                bodyStart = i + 1;
+            }
+            depth += 1;
+        }
+        else if (ch === ")") {
+            depth -= 1;
+            if (depth === 0) {
+                if (bodyStart === -1)
+                    return "";
+                return content.slice(bodyStart, i);
+            }
+        }
+        else if (!seenOpen && ch === ",") {
+            // The regex match consumed the verb's opening paren + path literal;
+            // the `,` we hit here is the outer call's separator, so walk back
+            // to the original opening paren (already past startIdx).
+            if (bodyStart === -1)
+                bodyStart = startIdx;
+            seenOpen = true;
+            depth = 1;
+        }
+        i += 1;
+    }
+    return "";
+}
+/** Extract top-level object keys from the first `res.json({...})` match. */
+function scrapeExpressResponseKeys(body) {
+    if (body.length === 0)
+        return undefined;
+    const callRe = /\b(?:res|response)\s*\.\s*(?:json|send)\s*\(\s*(\{[\s\S]*?\})\s*[,)]/;
+    const m = callRe.exec(body);
+    if (m === null)
+        return undefined;
+    const keys = parseTopLevelObjectKeys(m[1]);
+    return [...keys].sort();
+}
+/** Extract top-level keys from a `NextResponse.json({...})` / `Response.json({...})`. */
+function scrapeNextResponseKeys(handlerBody) {
+    if (handlerBody.length === 0)
+        return undefined;
+    const callRe = /\b(?:NextResponse|Response)\s*\.\s*json\s*\(\s*(\{[\s\S]*?\})\s*[,)]/;
+    const m = callRe.exec(handlerBody);
+    if (m === null)
+        return undefined;
+    const keys = parseTopLevelObjectKeys(m[1]);
+    return [...keys].sort();
+}
+/**
+ * Parse `{ key1: ..., key2: "x" }` and return the literal top-level keys.
+ * Strips nested object/array bodies so `{a:{b:1},c:2}` returns `[a,c]`.
+ * Computed keys (`[foo]: 1`) and spreads are dropped.
+ */
+function parseTopLevelObjectKeys(literal) {
+    const body = literal.slice(1, -1);
+    const keys = [];
+    let depth = 0;
+    let inString = null;
+    let tokenStart = 0;
+    let i = 0;
+    const boundary = () => {
+        const segment = body.slice(tokenStart, i).trim();
+        tokenStart = i + 1;
+        if (segment.length === 0)
+            return;
+        const colonIdx = segment.indexOf(":");
+        const keyPart = (colonIdx === -1 ? segment : segment.slice(0, colonIdx)).trim();
+        const m = /^['"]?([A-Za-z_$][\w$]*)['"]?$/.exec(keyPart);
+        if (m !== null)
+            keys.push(m[1]);
+    };
+    while (i < body.length) {
+        const ch = body[i];
+        if (inString !== null) {
+            if (ch === "\\") {
+                i += 2;
+                continue;
+            }
+            if (ch === inString)
+                inString = null;
+            i += 1;
+            continue;
+        }
+        if (ch === '"' || ch === "'" || ch === "`") {
+            inString = ch;
+            i += 1;
+            continue;
+        }
+        if (ch === "{" || ch === "[" || ch === "(")
+            depth += 1;
+        else if (ch === "}" || ch === "]" || ch === ")")
+            depth -= 1;
+        else if (ch === "," && depth === 0)
+            boundary();
+        i += 1;
+    }
+    boundary();
+    return keys;
+}
+/**
+ * Walk each Next.js verb handler's body for `NextResponse.json({...})` /
+ * `Response.json({...})` and attach the literal keys to the matching route.
+ * Returns a fresh array; callers must not mutate the originals.
+ */
+export function populateNextJsResponseKeys(routes, files) {
+    if (routes.length === 0)
+        return routes;
+    const contentByFile = new Map();
+    for (const f of files)
+        contentByFile.set(f.filePath, f.content);
+    return routes.map((r) => {
+        if (r.framework !== "nextjs")
+            return r;
+        if (r.method === undefined)
+            return r;
+        const content = findFileContent(contentByFile, r.handlerFile);
+        if (content === undefined)
+            return r;
+        const handlerBody = extractNextJsHandlerBody(content, r.method);
+        const keys = scrapeNextResponseKeys(handlerBody);
+        return keys !== undefined ? { ...r, responseKeys: keys } : r;
+    });
+}
+function findFileContent(contentByFile, handlerFile) {
+    const direct = contentByFile.get(handlerFile);
+    if (direct !== undefined)
+        return direct;
+    for (const [k, v] of contentByFile) {
+        if (k.endsWith(`/${handlerFile}`))
+            return v;
+    }
+    return undefined;
+}
+function extractNextJsHandlerBody(content, verb) {
+    const fnRe = new RegExp(`export\\s+(?:async\\s+)?function\\s+${verb}\\s*\\([^)]*\\)\\s*\\{`, "m");
+    const fnMatch = fnRe.exec(content);
+    if (fnMatch !== null) {
+        const start = fnMatch.index + fnMatch[0].length - 1;
+        return sliceBalancedBlock(content, start);
+    }
+    const constRe = new RegExp(`export\\s+const\\s+${verb}\\s*=\\s*(?:async\\s*)?\\([^)]*\\)\\s*=>\\s*\\{`, "m");
+    const constMatch = constRe.exec(content);
+    if (constMatch !== null) {
+        const start = constMatch.index + constMatch[0].length - 1;
+        return sliceBalancedBlock(content, start);
+    }
+    return "";
+}
+function sliceBalancedBlock(content, openBraceIdx) {
+    if (content[openBraceIdx] !== "{")
+        return "";
+    let depth = 0;
+    let inString = null;
+    for (let i = openBraceIdx; i < content.length; i += 1) {
+        const ch = content[i];
+        if (inString !== null) {
+            if (ch === "\\") {
+                i += 1;
+                continue;
+            }
+            if (ch === inString)
+                inString = null;
+            continue;
+        }
+        if (ch === '"' || ch === "'" || ch === "`") {
+            inString = ch;
+            continue;
+        }
+        if (ch === "{")
+            depth += 1;
+        else if (ch === "}") {
+            depth -= 1;
+            if (depth === 0)
+                return content.slice(openBraceIdx + 1, i);
+        }
+    }
+    return "";
+}
+//# sourceMappingURL=route-detector.js.map

package/dist/extract/route-detector.js.map

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

package/dist/extract/tool-detector.d.ts

@@ -0,0 +1,26 @@
+/**
+ * MCP / JSON-RPC tool detector.
+ *
+ * The heuristic is intentionally coarse: many agent frameworks (MCP, LangChain
+ * tools, OpenAI function schemas) converge on a `{ name, description, ... }`
+ * object literal for each tool. At MVP we only claim a match when the file
+ * path *also* signals "tool-ness", which eliminates the majority of false
+ * positives coming from generic config blocks.
+ *
+ * Pattern authored fresh — no external regex reused.
+ */
+import type { ExtractedTool, ExtractInput } from "./types.js";
+/**
+ * Translate an object literal written in relaxed JS syntax (single quotes,
+ * unquoted keys, trailing commas) into strict canonical JSON sorted by key.
+ * Returns `undefined` when the literal is too exotic to normalize safely
+ * (template strings, bareword values, computed keys).
+ */
+export declare function canonicalizeObjectLiteral(literal: string): string | undefined;
+/**
+ * Emit one `ExtractedTool` per `{ name, description }` literal pair found in
+ * the same 5-line window. Duplicates (same `toolName` + `description`) are
+ * de-duplicated per file; cross-file de-duplication is a later phase concern.
+ */
+export declare function detectMcpTools(input: ExtractInput): readonly ExtractedTool[];
+//# sourceMappingURL=tool-detector.d.ts.map

package/dist/extract/tool-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-detector.d.ts","sourceRoot":"","sources":["../../src/extract/tool-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAgI9D;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAU7E;AA8JD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,aAAa,EAAE,CAkD5E"}