purecontext-mcp 1.0.1

package/dist/adapters/nestjs.js

@@ -0,0 +1,401 @@
+/**
+ * NestJS framework adapter.
+ *
+ * Extracts HTTP route symbols from @Controller + HTTP-method decorators,
+ * and marks services, modules, guards, and interceptors with NestJS metadata.
+ *
+ * Route path merging: controller prefix + method decorator path.
+ * e.g. @Controller('users') + @Get(':id') → GET /users/:id
+ */
+import { createHash } from 'crypto';
+import { readFileSync } from 'fs';
+import { registerAdapter } from './adapter-registry.js';
+import { logger } from '../core/logger.js';
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function makeId(filePath, name, kind) {
+    return createHash('sha256')
+        .update(`${filePath}:${name}:${kind}`)
+        .digest('hex')
+        .slice(0, 16);
+}
+const HTTP_METHOD_DECORATORS = new Map([
+    ['@Get', 'GET'],
+    ['@Post', 'POST'],
+    ['@Put', 'PUT'],
+    ['@Patch', 'PATCH'],
+    ['@Delete', 'DELETE'],
+    ['@Head', 'HEAD'],
+    ['@Options', 'OPTIONS'],
+    ['@All', '*'],
+]);
+const NESTJS_CLASS_DECORATORS = new Set([
+    '@Injectable',
+    '@Module',
+    '@Guard',
+    '@Interceptor',
+    '@Middleware',
+    '@Catch',
+    '@WebSocketGateway',
+]);
+// ─── Decorator extraction ─────────────────────────────────────────────────────
+/**
+ * Extract the string path argument from a decorator like @Controller('users')
+ * or @Get(':id'). Returns '' for no-arg decorators like @Controller().
+ */
+function extractDecoratorPath(decoratorText) {
+    const m = decoratorText.match(/@\w+\s*\(\s*['"`]([^'"`]*)['"`]/);
+    return m ? m[1] : '';
+}
+/**
+ * Combine controller prefix and method path into a full route path.
+ */
+function buildRoutePath(prefix, methodPath) {
+    const p = prefix.startsWith('/') ? prefix : `/${prefix}`;
+    if (!methodPath)
+        return p;
+    const m = methodPath.startsWith('/') ? methodPath : `/${methodPath}`;
+    // Avoid double slashes
+    if (p === '/')
+        return m;
+    return `${p}${m}`;
+}
+function detectNestDecorator(classNode, sourceStr) {
+    // Walk back through named siblings (and parent for export_statement)
+    const candidates = [];
+    let prev = classNode.previousNamedSibling;
+    while (prev !== null && prev.type === 'decorator') {
+        candidates.push(prev);
+        prev = prev.previousNamedSibling;
+    }
+    // Also check decorators on parent export_statement
+    if (classNode.parent?.type === 'export_statement') {
+        let outerPrev = classNode.parent.previousNamedSibling;
+        while (outerPrev !== null && outerPrev.type === 'decorator') {
+            candidates.push(outerPrev);
+            outerPrev = outerPrev.previousNamedSibling;
+        }
+    }
+    // Check decorators as direct children of class node
+    for (const child of classNode.children) {
+        if (child.type === 'decorator')
+            candidates.push(child);
+    }
+    // Check if class implements CanActivate — takes priority over @Injectable,
+    // since `@Injectable() class X implements CanActivate` is the standard guard pattern.
+    const classText = sourceStr.slice(classNode.startIndex, classNode.endIndex);
+    if (/\bCanActivate\b/.test(classText)) {
+        return { type: 'guard' };
+    }
+    for (const dec of candidates) {
+        const text = sourceStr.slice(dec.startIndex, dec.endIndex);
+        if (text.startsWith('@Controller')) {
+            const prefix = extractDecoratorPath(text);
+            return { type: 'controller', prefix };
+        }
+        if (text.startsWith('@Injectable') || text.startsWith('@Service')) {
+            return { type: 'injectable' };
+        }
+        if (text.startsWith('@Module')) {
+            return { type: 'module' };
+        }
+        if (text.startsWith('@UseGuards') || text.startsWith('@Guard')) {
+            return { type: 'guard' };
+        }
+        if (text.startsWith('@UseInterceptors') || text.startsWith('@Interceptor')) {
+            return { type: 'interceptor' };
+        }
+        if (text.startsWith('@Middleware') || text.startsWith('@NestMiddleware')) {
+            return { type: 'middleware' };
+        }
+    }
+    return null;
+}
+/**
+ * Extract method symbols from a controller class body.
+ * Looks for method_definition nodes preceded by HTTP-method decorators.
+ */
+function extractControllerRoutes(classNode, sourceStr, filePath, controllerPrefix) {
+    const symbols = [];
+    // Find the class body
+    const body = classNode.children.find((c) => c.type === 'class_body');
+    if (!body)
+        return symbols;
+    for (const member of body.children) {
+        if (member.type !== 'method_definition' &&
+            member.type !== 'public_field_definition') {
+            continue;
+        }
+        // Check for HTTP method decorators on this member
+        let prev = member.previousNamedSibling;
+        while (prev !== null && prev.type === 'decorator') {
+            const decoratorText = sourceStr.slice(prev.startIndex, prev.endIndex);
+            for (const [decoratorName, httpMethod] of HTTP_METHOD_DECORATORS) {
+                if (decoratorText.startsWith(decoratorName)) {
+                    const methodPath = extractDecoratorPath(decoratorText);
+                    const fullPath = buildRoutePath(controllerPrefix, methodPath);
+                    const routeName = `${httpMethod} ${fullPath}`;
+                    symbols.push({
+                        id: makeId(filePath, routeName, 'route'),
+                        name: routeName,
+                        kind: 'route',
+                        filePath,
+                        startByte: member.startIndex,
+                        endByte: member.endIndex,
+                        signature: `@${decoratorName.slice(1)}('${methodPath}') ${routeName}`,
+                        summary: `NestJS route: ${routeName}`,
+                        frameworkMeta: {
+                            http_method: httpMethod,
+                            route_path: fullPath,
+                            controller_prefix: controllerPrefix,
+                        },
+                    });
+                    break;
+                }
+            }
+            prev = prev.previousNamedSibling;
+        }
+        // Also check decorators as direct children of the method
+        for (const child of member.children) {
+            if (child.type !== 'decorator')
+                continue;
+            const decoratorText = sourceStr.slice(child.startIndex, child.endIndex);
+            for (const [decoratorName, httpMethod] of HTTP_METHOD_DECORATORS) {
+                if (decoratorText.startsWith(decoratorName)) {
+                    const methodPath = extractDecoratorPath(decoratorText);
+                    const fullPath = buildRoutePath(controllerPrefix, methodPath);
+                    const routeName = `${httpMethod} ${fullPath}`;
+                    // Avoid duplicates
+                    if (!symbols.some((s) => s.name === routeName)) {
+                        symbols.push({
+                            id: makeId(filePath, routeName, 'route'),
+                            name: routeName,
+                            kind: 'route',
+                            filePath,
+                            startByte: member.startIndex,
+                            endByte: member.endIndex,
+                            signature: `@${decoratorName.slice(1)}('${methodPath}') ${routeName}`,
+                            summary: `NestJS route: ${routeName}`,
+                            frameworkMeta: {
+                                http_method: httpMethod,
+                                route_path: fullPath,
+                                controller_prefix: controllerPrefix,
+                            },
+                        });
+                    }
+                    break;
+                }
+            }
+        }
+    }
+    return symbols;
+}
+// ─── Text-based fallback route extraction ─────────────────────────────────────
+/**
+ * Regex-based extraction of NestJS routes as a fallback when AST traversal
+ * doesn't capture all decorators (e.g. stacked decorators, unusual formatting).
+ */
+function extractRoutesFromSource(sourceStr, filePath) {
+    const symbols = [];
+    // Find @Controller('prefix') ... @Get('/path') / @Post('/path') patterns
+    const controllerRe = /@Controller\s*\(\s*(?:['"`]([^'"`]*)['"`])?\s*\)/g;
+    const httpRe = /@(Get|Post|Put|Patch|Delete|Head|Options|All)\s*\(\s*(?:['"`]([^'"`]*)['"`])?\s*\)/g;
+    let controllerMatch;
+    while ((controllerMatch = controllerRe.exec(sourceStr)) !== null) {
+        const prefix = controllerMatch[1] ?? '';
+        const controllerEnd = sourceStr.indexOf('{', controllerMatch.index);
+        if (controllerEnd === -1)
+            continue;
+        // Find the class body end (simplified: find matching braces)
+        let depth = 1;
+        let bodyEnd = controllerEnd + 1;
+        while (depth > 0 && bodyEnd < sourceStr.length) {
+            if (sourceStr[bodyEnd] === '{')
+                depth++;
+            else if (sourceStr[bodyEnd] === '}')
+                depth--;
+            bodyEnd++;
+        }
+        const classBody = sourceStr.slice(controllerEnd, bodyEnd);
+        httpRe.lastIndex = 0;
+        let httpMatch;
+        while ((httpMatch = httpRe.exec(classBody)) !== null) {
+            const httpDecoratorName = httpMatch[1];
+            const methodPath = httpMatch[2] ?? '';
+            const httpMethod = HTTP_METHOD_DECORATORS.get(`@${httpDecoratorName}`) ?? httpDecoratorName.toUpperCase();
+            const fullPath = buildRoutePath(prefix, methodPath);
+            const routeName = `${httpMethod} ${fullPath}`;
+            if (!symbols.some((s) => s.name === routeName)) {
+                symbols.push({
+                    id: makeId(filePath, routeName, 'route'),
+                    name: routeName,
+                    kind: 'route',
+                    filePath,
+                    startByte: 0,
+                    endByte: 0,
+                    signature: `@${httpDecoratorName}('${methodPath}') → ${routeName}`,
+                    summary: `NestJS route: ${routeName}`,
+                    frameworkMeta: {
+                        http_method: httpMethod,
+                        route_path: fullPath,
+                        controller_prefix: prefix,
+                    },
+                });
+            }
+        }
+    }
+    return symbols;
+}
+// ─── Class symbol extraction ──────────────────────────────────────────────────
+function walkForNestClasses(nodes, sourceStr, filePath, symbols) {
+    for (const node of nodes) {
+        let classNode = null;
+        if (node.type === 'class_declaration') {
+            classNode = node;
+        }
+        else if (node.type === 'export_statement') {
+            const inner = node.children.find((c) => c.type === 'class_declaration');
+            if (inner)
+                classNode = inner;
+        }
+        if (classNode === null)
+            continue;
+        const nameNode = classNode.children.find((c) => c.type === 'type_identifier' || c.type === 'identifier');
+        if (!nameNode)
+            continue;
+        const className = sourceStr.slice(nameNode.startIndex, nameNode.endIndex);
+        if (!className)
+            continue;
+        const decInfo = detectNestDecorator(classNode, sourceStr);
+        if (!decInfo)
+            continue;
+        if (decInfo.type === 'controller') {
+            // Controller: emit route symbols for each HTTP-method decorated method
+            const prefix = decInfo.prefix ?? '';
+            const routes = extractControllerRoutes(classNode, sourceStr, filePath, prefix);
+            symbols.push(...routes);
+            continue;
+        }
+        if (decInfo.type === 'injectable') {
+            symbols.push({
+                id: makeId(filePath, className, 'class'),
+                name: className,
+                kind: 'class',
+                filePath,
+                startByte: classNode.startIndex,
+                endByte: classNode.endIndex,
+                signature: `@Injectable() class ${className}`,
+                summary: `NestJS service: ${className}`,
+                frameworkMeta: { nestjs_provider: true },
+            });
+            continue;
+        }
+        if (decInfo.type === 'module') {
+            symbols.push({
+                id: makeId(filePath, className, 'class'),
+                name: className,
+                kind: 'class',
+                filePath,
+                startByte: classNode.startIndex,
+                endByte: classNode.endIndex,
+                signature: `@Module() class ${className}`,
+                summary: `NestJS module: ${className}`,
+                frameworkMeta: { nestjs_module: true },
+            });
+            continue;
+        }
+        if (decInfo.type === 'guard') {
+            symbols.push({
+                id: makeId(filePath, className, 'middleware'),
+                name: className,
+                kind: 'middleware',
+                filePath,
+                startByte: classNode.startIndex,
+                endByte: classNode.endIndex,
+                signature: `class ${className} implements CanActivate`,
+                summary: `NestJS guard: ${className}`,
+                frameworkMeta: { nestjs_guard: true },
+            });
+            continue;
+        }
+        if (decInfo.type === 'interceptor') {
+            symbols.push({
+                id: makeId(filePath, className, 'middleware'),
+                name: className,
+                kind: 'middleware',
+                filePath,
+                startByte: classNode.startIndex,
+                endByte: classNode.endIndex,
+                signature: `@Interceptor() class ${className}`,
+                summary: `NestJS interceptor: ${className}`,
+                frameworkMeta: { nestjs_interceptor: true },
+            });
+            continue;
+        }
+        if (decInfo.type === 'middleware') {
+            symbols.push({
+                id: makeId(filePath, className, 'middleware'),
+                name: className,
+                kind: 'middleware',
+                filePath,
+                startByte: classNode.startIndex,
+                endByte: classNode.endIndex,
+                signature: `class ${className} implements NestMiddleware`,
+                summary: `NestJS middleware: ${className}`,
+                frameworkMeta: { nestjs_middleware: true },
+            });
+            continue;
+        }
+    }
+}
+// ─── NestJS adapter ───────────────────────────────────────────────────────────
+export const nestjsAdapter = {
+    name: 'nestjs',
+    extensions: () => [],
+    // ── Detection ───────────────────────────────────────────────────────────────
+    async detect(projectRoot) {
+        try {
+            const raw = readFileSync(`${projectRoot}/package.json`, 'utf8');
+            const pkg = JSON.parse(raw);
+            const deps = Object.assign({}, pkg['dependencies'], pkg['devDependencies']);
+            return '@nestjs/core' in deps || '@nestjs/common' in deps;
+        }
+        catch {
+            return false;
+        }
+    },
+    // ── File routing ─────────────────────────────────────────────────────────────
+    fileFilter: (filePath) => filePath.endsWith('.controller.ts') ||
+        filePath.endsWith('.service.ts') ||
+        filePath.endsWith('.module.ts') ||
+        filePath.endsWith('.guard.ts') ||
+        filePath.endsWith('.middleware.ts') ||
+        filePath.endsWith('.interceptor.ts') ||
+        filePath.endsWith('.pipe.ts') ||
+        filePath.endsWith('.decorator.ts'),
+    // ── Framework symbol extraction ──────────────────────────────────────────────
+    extractFrameworkSymbols(tree, source, filePath) {
+        const sourceStr = source.toString('utf8');
+        const symbols = [];
+        // AST-based extraction for class symbols and routes
+        if (tree !== null) {
+            walkForNestClasses(tree.rootNode.children, sourceStr, filePath, symbols);
+        }
+        // Text-based fallback for route extraction (catches cases AST misses)
+        if (filePath.endsWith('.controller.ts')) {
+            const textRoutes = extractRoutesFromSource(sourceStr, filePath);
+            for (const route of textRoutes) {
+                if (!symbols.some((s) => s.name === route.name)) {
+                    symbols.push(route);
+                }
+            }
+        }
+        return symbols;
+    },
+    enrichMetadata(symbol) {
+        return symbol;
+    },
+};
+// ─── Self-registration ────────────────────────────────────────────────────────
+registerAdapter(nestjsAdapter);
+logger.debug("Adapter 'nestjs' registered");
+//# sourceMappingURL=nestjs.js.map

package/dist/adapters/nestjs.js.map

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

package/dist/adapters/nextjs.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Next.js framework adapter.
+ *
+ * Handles both the Pages Router and App Router conventions, emitting route,
+ * component, and middleware symbols from file-path analysis and (for App Router
+ * API routes) lightweight AST scanning.
+ *
+ * Detection: presence of next.config.{js,ts,mjs,cjs} OR `next` in package.json
+ * dependencies.
+ *
+ * Works alongside the React adapter — React promotes functions to components/hooks,
+ * Next.js emits route symbols and enriches those components with route metadata.
+ *
+ * File categories handled:
+ *   pages/[*]  (not pages/api/)        → route symbol (Pages Router page)
+ *   pages/api/[*]                       → route symbol (Pages Router API)
+ *   app/[*]/page.{tsx,jsx}             → route symbol (App Router page)
+ *   app/[*]/layout|loading|error|not-found.{tsx,jsx} → component symbol (special file)
+ *   app/[*]/route.{ts,js}             → route symbols per exported HTTP method
+ *   middleware.{ts,js}                  → middleware symbol
+ *
+ * All paths also support an optional src/ prefix (Next.js convention).
+ */
+import type { FrameworkAdapter } from '../core/types.js';
+/**
+ * Derive the URL route path for a Pages Router file.
+ *   'pages/index.tsx'          → '/'
+ *   'pages/about.tsx'          → '/about'
+ *   'pages/blog/[slug].tsx'    → '/blog/:slug'
+ *   'pages/[...catch].tsx'     → '/*catch'
+ *   'pages/[[...opt]].tsx'     → '/*opt?'
+ *
+ * normalizedPath must already have any src/ prefix stripped.
+ */
+export declare function derivePageRouterPath(normalizedPath: string): string;
+/**
+ * Derive the URL route path for an App Router file (page.tsx, layout.tsx, route.ts…).
+ * The path is determined by the directory containing the file, not the filename.
+ *   'app/page.tsx'                        → '/'
+ *   'app/about/page.tsx'                  → '/about'
+ *   'app/blog/[slug]/page.tsx'            → '/blog/:slug'
+ *   'app/(marketing)/about/page.tsx'      → '/about'
+ *   'app/api/users/route.ts'              → '/api/users'
+ *
+ * normalizedPath must already have any src/ prefix stripped.
+ */
+export declare function deriveAppRouterPath(normalizedPath: string): string;
+export declare const nextjsAdapter: FrameworkAdapter;
+//# sourceMappingURL=nextjs.d.ts.map

package/dist/adapters/nextjs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs.d.ts","sourceRoot":"","sources":["../../src/adapters/nextjs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,kBAAkB,CAAC;AA0D7E;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAUnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAUlE;AAmFD,eAAO,MAAM,aAAa,EAAE,gBA0P3B,CAAC"}