openlore 2.0.0

package/dist/core/analyzer/http-route-parser.d.ts

@@ -0,0 +1,152 @@
+/**
+ * HTTP Route Parser
+ *
+ * Extracts two complementary sets of data:
+ *   1. HTTP CALLS  — fetch/axios/ky/got calls in JS/TS frontend files
+ *   2. ROUTE DEFS  — FastAPI / Flask / Django route declarations in Python files
+ *
+ * These are then matched by `buildHttpEdges()` to create cross-language edges
+ * between the frontend files that call an endpoint and the Python handlers that
+ * serve it — filling the gap that static import analysis cannot reach.
+ *
+ * Matching strategy
+ * -----------------
+ * Routes are normalised to a canonical form before comparison:
+ *   - Path parameters are replaced with a placeholder: /items/{id} → /items/:param
+ *   - Leading slashes are normalised
+ *   - Query strings are stripped from call-site URLs
+ *   - Common API prefixes (/api, /api/v1, /v1, …) are tried both with and
+ *     without the prefix so that a frontend call to /api/v1/search still matches
+ *     a FastAPI router mounted at /search.
+ *
+ * Confidence levels
+ * -----------------
+ *   exact   — method + full path match
+ *   path    — path matches, method unknown on one side (e.g. bare fetch)
+ *   fuzzy   — normalised path matches after prefix stripping
+ */
+/** An HTTP call found in a JS/TS source file */
+export interface HttpCall {
+    /** Absolute path of the file containing the call */
+    file: string;
+    /** HTTP method, upper-cased. 'UNKNOWN' when it cannot be determined. */
+    method: string;
+    /** URL as written in source — may be a template literal or variable ref */
+    url: string;
+    /** Normalised, static portion of the URL (params stripped, prefix removed) */
+    normalizedUrl: string;
+    /** 1-based source line */
+    line: number;
+    /** axios / fetch / ky / got / custom */
+    client: string;
+}
+/** A route handler found in a Python source file */
+export interface RouteDefinition {
+    /** Absolute path of the file containing the handler */
+    file: string;
+    /** HTTP method, upper-cased */
+    method: string;
+    /** Path pattern as declared (may contain {param} or <param> placeholders) */
+    path: string;
+    /** Normalised path for matching */
+    normalizedPath: string;
+    /** Name of the handler function */
+    handlerName: string;
+    /** fastapi / flask / django / starlette / express / nestjs / nextjs-app etc. */
+    framework: string;
+    /** 1-based source line */
+    line: number;
+    /** Request body type extracted from handler signature, e.g. "CreateUserDto" or "z.infer<typeof schema>" */
+    requestBodyType?: string;
+    /** Response body type extracted from handler return type annotation, e.g. "User[]" or "void" */
+    responseType?: string;
+    /** How the contract was sourced */
+    contractSource: 'annotation' | 'validator' | 'none';
+}
+/** A resolved cross-language edge */
+export interface HttpEdge {
+    /** Absolute path of the JS/TS caller file */
+    callerFile: string;
+    /** Absolute path of the Python handler file */
+    handlerFile: string;
+    method: string;
+    /** Normalised path used for the match */
+    path: string;
+    call: HttpCall;
+    route: RouteDefinition;
+    /** How confident the match is */
+    confidence: 'exact' | 'path' | 'fuzzy';
+}
+/**
+ * Reduce a URL/path to a comparable canonical form:
+ *   - Strip protocol + host if present  (https://example.com/foo → /foo)
+ *   - Strip query string and fragment
+ *   - Replace path parameters with :param
+ *     {id}, :id, <int:id>, <id>  →  :param
+ *   - Collapse duplicate slashes
+ *   - Remove trailing slash (except root)
+ */
+export declare function normalizeUrl(raw: string): string;
+/**
+ * Extract all HTTP calls from a JavaScript or TypeScript source file.
+ */
+export declare function extractHttpCalls(filePath: string): Promise<HttpCall[]>;
+/**
+ * Extract all route definitions from a Python source file.
+ * Supports FastAPI, Starlette, Flask, and Django (urls.py path/re_path).
+ */
+export declare function extractRouteDefinitions(filePath: string): Promise<RouteDefinition[]>;
+/**
+ * Extract all HTTP route definitions from a Java source file.
+ * Supports Spring MVC (@RestController / @Controller + @RequestMapping and the
+ * shorthand @GetMapping / @PostMapping / …) and JAX-RS (@Path + @GET / @POST).
+ */
+export declare function extractJavaRouteDefinitions(filePath: string): Promise<RouteDefinition[]>;
+/**
+ * Match HTTP calls from JS/TS files against route definitions from Python files
+ * and return cross-language edges.
+ *
+ * Pass in pre-extracted calls and routes (so callers can cache them across
+ * multiple graph builds without re-parsing).
+ */
+export declare function buildHttpEdges(calls: HttpCall[], routes: RouteDefinition[]): HttpEdge[];
+/**
+ * Parse all files in a mixed JS+Python codebase and return HTTP edges.
+ * Intended to be called once per graph build and its result merged into
+ * the DependencyGraphResult edges.
+ */
+export declare function extractAllHttpEdges(filePaths: string[]): Promise<{
+    calls: HttpCall[];
+    routes: RouteDefinition[];
+    edges: HttpEdge[];
+}>;
+/**
+ * Extract HTTP route definitions from a TypeScript/JavaScript server file.
+ * Handles Express-style, NestJS decorators, and Next.js App Router.
+ */
+export declare function extractTsRouteDefinitions(filePath: string): Promise<RouteDefinition[]>;
+export interface RouteInventory {
+    total: number;
+    byMethod: Record<string, number>;
+    byFramework: Record<string, number>;
+    routes: Array<{
+        method: string;
+        path: string;
+        framework: string;
+        file: string;
+        handler: string;
+        requestBodyType?: string;
+        responseType?: string;
+        contractSource: 'annotation' | 'validator' | 'none';
+    }>;
+}
+/**
+ * Build a complete route inventory from all source files.
+ * Combines Python routes (extractRouteDefinitions) and TS/JS routes
+ * (extractTsRouteDefinitions) into a single summary.
+ *
+ * @param filePaths - Absolute paths to all source files in the project
+ * @param rootDir   - Project root for computing relative paths
+ */
+export declare function buildRouteInventory(filePaths: string[], rootDir: string): Promise<RouteInventory>;
+//# sourceMappingURL=http-route-parser.d.ts.map

package/dist/core/analyzer/http-route-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-route-parser.d.ts","sourceRoot":"","sources":["../../../src/core/analyzer/http-route-parser.ts"],"names":[],"mappings":"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"}