codeguardian-mcp 1.0.0

package/dist/api-contract/extractors/tsAstUtils.js

@@ -0,0 +1,173 @@
+/**
+ * API Contract Guardian - TypeScript AST Utilities
+ *
+ * Shared Tree-sitter helpers for extracting:
+ * - HTTP methods from call expressions
+ * - endpoints from string/template_string arguments
+ * - enclosing function/property names
+ *
+ * Used by both:
+ * - `src/api-contract/extractors/typescript.ts`
+ * - `src/context/apiContractExtraction.ts`
+ *
+ * @format
+ */
+export function getNodeText(node, content) {
+    if (!node)
+        return "";
+    return content.slice(node.startIndex, node.endIndex);
+}
+export function mapToHttpMethod(methodName) {
+    const methodMap = {
+        get: "GET",
+        post: "POST",
+        put: "PUT",
+        patch: "PATCH",
+        delete: "DELETE",
+    };
+    return methodMap[methodName.toLowerCase()] || null;
+}
+export function extractHttpMethodFromArguments(argumentsNode, content) {
+    for (const child of argumentsNode?.children || []) {
+        if (child?.type === "object") {
+            return extractMethodFromObject(child, content);
+        }
+    }
+    return null;
+}
+function extractMethodFromObject(node, content) {
+    for (const child of node?.children || []) {
+        if (child?.type !== "pair")
+            continue;
+        const keyNode = child.childForFieldName?.("key");
+        const valueNode = child.childForFieldName?.("value");
+        if (!keyNode || !valueNode)
+            continue;
+        const key = getNodeText(keyNode, content);
+        if (key !== "method")
+            continue;
+        const raw = getNodeText(valueNode, content).trim();
+        const cleaned = raw.replace(/^['"`]/, "").replace(/['"`]$/, "");
+        return mapToHttpMethod(cleaned);
+    }
+    return null;
+}
+export function extractEndpointFromArguments(argumentsNode, content) {
+    // First argument should be the endpoint
+    for (const child of argumentsNode?.children || []) {
+        if (child?.type === "string" || child?.type === "template_string") {
+            const result = extractStringValue(child, content);
+            if (result)
+                return result;
+        }
+    }
+    return null;
+}
+/**
+ * Extract a URL/endpoint from a string or template_string node.
+ *
+ * For template strings, reconstruct a stable path with placeholders.
+ * Examples:
+ * - `/api/clients/${id}` -> `/api/clients/{id}`
+ * - `/pantry${category ? '?cat=...' : ''}` -> `/pantry`
+ */
+export function extractStringValue(node, content) {
+    if (node?.type === "string") {
+        const text = getNodeText(node, content).trim();
+        const cleaned = text.replace(/^['"`]/, "").replace(/['"`]$/, "");
+        const queryParams = extractQueryParamsFromUrl(cleaned);
+        let endpoint = cleaned.split("?")[0].replace(/\/$/, "");
+        if (!endpoint || endpoint === "/")
+            return null;
+        return { endpoint, queryParams };
+    }
+    if (node?.type === "template_string") {
+        const parts = [];
+        for (const child of node.children || []) {
+            if (child?.type === "string_fragment") {
+                parts.push(getNodeText(child, content));
+                continue;
+            }
+            if (child?.type === "template_substitution") {
+                const exprNode = child.children?.find((c) => c?.type !== "${" && c?.type !== "}");
+                if (!exprNode)
+                    continue;
+                const exprText = getNodeText(exprNode, content).trim();
+                // Skip query string builders (commonly appended at end)
+                if (/^(query|params|searchParams|queryString)$/i.test(exprText))
+                    continue;
+                // Skip ternary expressions likely building optional query strings
+                if (exprNode.type === "ternary_expression")
+                    continue;
+                // Stable placeholder for simple identifiers
+                if (exprNode.type === "identifier") {
+                    const snakeCase = exprText.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`);
+                    parts.push(`{${snakeCase}}`);
+                }
+            }
+        }
+        if (parts.length === 0)
+            return null;
+        const fullUrl = parts.join("");
+        const queryParams = extractQueryParamsFromUrl(fullUrl);
+        let endpoint = fullUrl.split("?")[0].replace(/\/$/, "");
+        if (!endpoint || endpoint === "/")
+            return null;
+        return { endpoint, queryParams };
+    }
+    return null;
+}
+function extractQueryParamsFromUrl(url) {
+    const queryStart = url.indexOf("?");
+    if (queryStart === -1)
+        return [];
+    const queryString = url.substring(queryStart + 1);
+    const params = [];
+    for (const pair of queryString.split("&")) {
+        const eqIndex = pair.indexOf("=");
+        if (eqIndex <= 0)
+            continue;
+        const name = pair.substring(0, eqIndex).trim();
+        if (name && /^[a-zA-Z_][a-zA-Z0-9_]*$/.test(name)) {
+            params.push({ name, type: "string", required: true });
+        }
+    }
+    return params;
+}
+/**
+ * Find the nearest enclosing function-like name for an AST node.
+ *
+ * Supports:
+ * - function_declaration
+ * - variable_declarator (arrow function assigned to const)
+ * - method_definition
+ * - object properties (pair/property_definition)
+ */
+export function findEnclosingFunctionName(node, content) {
+    let current = node;
+    while (current) {
+        if (current.type === "function_declaration") {
+            const nameNode = current.childForFieldName?.("name");
+            if (nameNode)
+                return getNodeText(nameNode, content);
+        }
+        if (current.type === "variable_declarator") {
+            const nameNode = current.childForFieldName?.("name");
+            if (nameNode)
+                return getNodeText(nameNode, content);
+        }
+        if (current.type === "method_definition") {
+            const nameNode = current.childForFieldName?.("name");
+            if (nameNode)
+                return getNodeText(nameNode, content);
+        }
+        if (current.type === "property_definition" || current.type === "pair") {
+            const keyNode = current.childForFieldName?.("key") || current.childForFieldName?.("name");
+            if (keyNode)
+                return getNodeText(keyNode, content);
+        }
+        current = current.parent;
+    }
+    return null;
+}
+//# sourceMappingURL=tsAstUtils.js.map

package/dist/api-contract/extractors/tsAstUtils.js.map

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

package/dist/api-contract/extractors/typescript.d.ts

@@ -0,0 +1,32 @@
+/**
+ * API Contract Guardian - TypeScript Extractor (AST-based)
+ *
+ * Extracts API service functions and TypeScript types/interfaces using AST.
+ *
+ * @format
+ */
+import type { ServiceDefinition, TypeDefinition, HttpClient } from "../types.js";
+/**
+ * Extract all API service functions from a project
+ */
+export declare function extractServices(projectPath: string): Promise<ServiceDefinition[]>;
+/**
+ * Extract service functions from a single file using AST
+ */
+export declare function extractServicesFromFile(content: string, filePath: string): ServiceDefinition[];
+/**
+ * Extract all TypeScript types/interfaces from a project
+ */
+export declare function extractTypes(projectPath: string): Promise<TypeDefinition[]>;
+/**
+ * Extract types/interfaces from a single file using AST
+ */
+export declare function extractTypesFromFile(content: string, filePath: string): TypeDefinition[];
+/**
+ * Extract API configuration from a project
+ */
+export declare function extractApiConfig(projectPath: string): Promise<{
+    apiBaseUrl: string;
+    httpClient: HttpClient;
+}>;
+//# sourceMappingURL=typescript.d.ts.map

package/dist/api-contract/extractors/typescript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../../../src/api-contract/extractors/typescript.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EAEd,UAAU,EACX,MAAM,aAAa,CAAC;AAMrB;;GAEG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAwC9B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,iBAAiB,EAAE,CAerB;AAgZD;;GAEG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,EAAE,CAAC,CAyC3B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CAcxF;AA2MD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IACT,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;CACxB,CAAC,CAgDD"}