purecontext-mcp 1.0.1

package/dist/adapters/nextjs.js

@@ -0,0 +1,412 @@
+/**
+ * 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 { createHash } from 'crypto';
+import { basename, dirname } from 'path';
+import { existsSync, readFileSync } from 'fs';
+import { registerAdapter } from './adapter-registry.js';
+import { logger } from '../core/logger.js';
+// ─── Constants ────────────────────────────────────────────────────────────────
+const NEXT_CONFIG_NAMES = [
+    'next.config.js',
+    'next.config.ts',
+    'next.config.mjs',
+    'next.config.cjs',
+];
+const HTTP_METHODS = new Set([
+    'GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS',
+]);
+const APP_SPECIAL_FILES = {
+    'layout': 'layout',
+    'loading': 'loading',
+    'error': 'error',
+    'not-found': 'not-found',
+};
+// ─── Symbol ID ────────────────────────────────────────────────────────────────
+function makeId(filePath, name, kind) {
+    return createHash('sha256')
+        .update(`${filePath}:${name}:${kind}`)
+        .digest('hex')
+        .slice(0, 16);
+}
+// ─── Path normalisation ───────────────────────────────────────────────────────
+/** Strip optional src/ prefix so categorisation logic only has one form to handle. */
+function normalizePath(filePath) {
+    return filePath.startsWith('src/') ? filePath.slice(4) : filePath;
+}
+// ─── Route path derivation ─────────────────────────────────────────────────
+/**
+ * Convert a single path segment with Next.js dynamic syntax to a URL parameter.
+ *   '[id]'           → ':id'
+ *   '[...slug]'      → '*slug'
+ *   '[[...optional]]'→ '*optional?'
+ *   '(group)'        → null (App Router route groups — strip from path)
+ *   normal segment   → unchanged
+ */
+function convertSegment(seg, stripGroups) {
+    if (stripGroups && seg.startsWith('(') && seg.endsWith(')'))
+        return null;
+    if (seg.startsWith('[[...') && seg.endsWith(']]'))
+        return '*' + seg.slice(5, -2) + '?';
+    if (seg.startsWith('[...') && seg.endsWith(']'))
+        return '*' + seg.slice(4, -1);
+    if (seg.startsWith('[') && seg.endsWith(']'))
+        return ':' + seg.slice(1, -1);
+    return seg;
+}
+/**
+ * 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 function derivePageRouterPath(normalizedPath) {
+    const withoutPrefix = normalizedPath.slice('pages/'.length);
+    const withoutExt = withoutPrefix.replace(/\.(tsx|jsx|ts|js)$/, '');
+    const parts = withoutExt
+        .split('/')
+        .map((seg) => convertSegment(seg, false))
+        .filter((s) => s !== null);
+    if (parts[parts.length - 1] === 'index')
+        parts.pop();
+    if (parts.length === 0)
+        return '/';
+    return '/' + parts.join('/');
+}
+/**
+ * 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 function deriveAppRouterPath(normalizedPath) {
+    const withoutApp = normalizedPath.slice('app/'.length);
+    const dir = dirname(withoutApp);
+    if (dir === '.')
+        return '/';
+    const parts = dir
+        .split('/')
+        .map((seg) => convertSegment(seg, true)) // strip route groups
+        .filter((s) => s !== null);
+    if (parts.length === 0)
+        return '/';
+    return '/' + parts.join('/');
+}
+function getCategory(normalizedPath) {
+    // Middleware at project root (after src/ stripping)
+    if (normalizedPath === 'middleware.ts' || normalizedPath === 'middleware.js') {
+        return 'root-middleware';
+    }
+    // Pages Router API must be checked before generic pages
+    if (normalizedPath.startsWith('pages/api/') &&
+        /\.(ts|js)$/.test(normalizedPath)) {
+        return 'pages-router-api';
+    }
+    // Pages Router pages
+    if (normalizedPath.startsWith('pages/') &&
+        /\.(tsx|jsx|ts|js)$/.test(normalizedPath)) {
+        return 'pages-router-page';
+    }
+    // App Router files — categorise by filename
+    if (normalizedPath.startsWith('app/')) {
+        const base = basename(normalizedPath, '.tsx').replace(/\.(jsx|ts|js)$/, '');
+        if (base === 'page')
+            return 'app-router-page';
+        if (base === 'route')
+            return 'app-router-api';
+        if (base in APP_SPECIAL_FILES)
+            return 'app-router-special';
+    }
+    return null;
+}
+// ─── AST helpers ──────────────────────────────────────────────────────────────
+/**
+ * Scan a parsed TypeScript/JavaScript tree for top-level exported names.
+ * Used to find which HTTP methods are exported from App Router route.ts files.
+ */
+function findExportedNames(tree) {
+    const names = new Set();
+    if (!tree)
+        return names;
+    for (const node of tree.rootNode.children) {
+        if (node.type !== 'export_statement')
+            continue;
+        for (const child of node.children) {
+            if (child.type === 'function_declaration') {
+                const ident = child.children.find((c) => c.type === 'identifier');
+                if (ident)
+                    names.add(ident.text);
+            }
+            else if (child.type === 'lexical_declaration') {
+                for (const decl of child.children) {
+                    if (decl.type === 'variable_declarator') {
+                        const ident = decl.children.find((c) => c.type === 'identifier');
+                        if (ident)
+                            names.add(ident.text);
+                    }
+                }
+            }
+        }
+    }
+    return names;
+}
+/** Check for 'use client' directive at the top of the file. */
+function hasUseClientDirective(source) {
+    const top = source.slice(0, 200).toString('utf8').trimStart();
+    return top.startsWith("'use client'") || top.startsWith('"use client"');
+}
+// ─── Next.js adapter ──────────────────────────────────────────────────────────
+export const nextjsAdapter = {
+    name: 'nextjs',
+    /** No new extensions — TS/JS handlers already cover .tsx/.jsx/.ts/.js. */
+    extensions: () => [],
+    // ── Detection ───────────────────────────────────────────────────────────────
+    async detect(projectRoot) {
+        // Config file presence is the most reliable signal
+        if (NEXT_CONFIG_NAMES.some((name) => existsSync(`${projectRoot}/${name}`))) {
+            return true;
+        }
+        // Fall back to package.json dependency check
+        try {
+            const raw = readFileSync(`${projectRoot}/package.json`, 'utf8');
+            const pkg = JSON.parse(raw);
+            const deps = Object.assign({}, pkg['dependencies'], pkg['devDependencies']);
+            return 'next' in deps;
+        }
+        catch {
+            return false;
+        }
+    },
+    // ── File routing ─────────────────────────────────────────────────────────────
+    fileFilter(filePath) {
+        return getCategory(normalizePath(filePath)) !== null;
+    },
+    // No preProcess — TS/JS handlers parse .tsx/.jsx/.ts/.js files directly.
+    // ── Framework symbol extraction ──────────────────────────────────────────────
+    extractFrameworkSymbols(tree, source, filePath) {
+        const p = normalizePath(filePath);
+        const category = getCategory(p);
+        if (!category)
+            return [];
+        switch (category) {
+            case 'pages-router-page': {
+                const routePath = derivePageRouterPath(p);
+                return [
+                    {
+                        id: makeId(filePath, routePath, 'route'),
+                        name: routePath,
+                        kind: 'route',
+                        filePath,
+                        startByte: 0,
+                        endByte: source.length,
+                        signature: `GET ${routePath}`,
+                        summary: `Next.js page ${routePath}`,
+                        frameworkMeta: {
+                            route_path: routePath,
+                            router: 'pages',
+                            nextjs_page: true,
+                        },
+                    },
+                ];
+            }
+            case 'pages-router-api': {
+                const routePath = derivePageRouterPath(p.replace('/api', '')).replace(/^\//, '/api/').replace('/api//', '/api/');
+                // Simpler: just strip pages/ prefix and /api/ is preserved
+                const apiPath = '/' + p.slice('pages/'.length).replace(/\.(ts|js)$/, '');
+                const cleanPath = apiPath
+                    .split('/')
+                    .map((seg) => convertSegment(seg, false))
+                    .filter((s) => s !== null)
+                    .join('/');
+                const finalPath = '/' + cleanPath.replace(/^\//, '').replace(/\/index$/, '');
+                return [
+                    {
+                        id: makeId(filePath, finalPath, 'route'),
+                        name: finalPath,
+                        kind: 'route',
+                        filePath,
+                        startByte: 0,
+                        endByte: source.length,
+                        signature: finalPath,
+                        summary: `Next.js API route ${finalPath}`,
+                        frameworkMeta: {
+                            route_path: finalPath,
+                            api_route: true,
+                            router: 'pages',
+                        },
+                    },
+                ];
+            }
+            case 'app-router-page': {
+                const routePath = deriveAppRouterPath(p);
+                const isClient = hasUseClientDirective(source);
+                return [
+                    {
+                        id: makeId(filePath, routePath, 'route'),
+                        name: routePath,
+                        kind: 'route',
+                        filePath,
+                        startByte: 0,
+                        endByte: source.length,
+                        signature: `GET ${routePath}`,
+                        summary: `Next.js App Router page ${routePath}`,
+                        frameworkMeta: {
+                            route_path: routePath,
+                            router: 'app',
+                            nextjs_page: true,
+                            ...(isClient ? { client_component: true } : { server_component: true }),
+                        },
+                    },
+                ];
+            }
+            case 'app-router-special': {
+                const fileBase = basename(p, '.tsx').replace(/\.(jsx|ts|js)$/, '');
+                const specialKind = APP_SPECIAL_FILES[fileBase] ?? fileBase;
+                const routePath = deriveAppRouterPath(p);
+                const name = `${fileBase}:${routePath}`;
+                return [
+                    {
+                        id: makeId(filePath, name, 'component'),
+                        name,
+                        kind: 'component',
+                        filePath,
+                        startByte: 0,
+                        endByte: source.length,
+                        signature: `${fileBase} ${routePath}`,
+                        summary: `Next.js ${specialKind} for ${routePath}`,
+                        frameworkMeta: {
+                            route_path: routePath,
+                            router: 'app',
+                            nextjs_special: specialKind,
+                        },
+                    },
+                ];
+            }
+            case 'app-router-api': {
+                const routePath = deriveAppRouterPath(p);
+                const exportedNames = findExportedNames(tree);
+                const methods = [...HTTP_METHODS].filter((m) => exportedNames.has(m));
+                // If no known HTTP method exports found, emit a generic route symbol
+                if (methods.length === 0) {
+                    return [
+                        {
+                            id: makeId(filePath, routePath, 'route'),
+                            name: routePath,
+                            kind: 'route',
+                            filePath,
+                            startByte: 0,
+                            endByte: source.length,
+                            signature: routePath,
+                            summary: `Next.js API route ${routePath}`,
+                            frameworkMeta: { route_path: routePath, api_route: true, router: 'app' },
+                        },
+                    ];
+                }
+                return methods.map((method) => ({
+                    id: makeId(filePath, `${method}:${routePath}`, 'route'),
+                    name: `${method} ${routePath}`,
+                    kind: 'route',
+                    filePath,
+                    startByte: 0,
+                    endByte: source.length,
+                    signature: `${method} ${routePath}`,
+                    summary: `Next.js API route ${method} ${routePath}`,
+                    frameworkMeta: {
+                        route_path: routePath,
+                        http_method: method,
+                        api_route: true,
+                        router: 'app',
+                    },
+                }));
+            }
+            case 'root-middleware': {
+                return [
+                    {
+                        id: makeId(filePath, 'middleware', 'middleware'),
+                        name: 'middleware',
+                        kind: 'middleware',
+                        filePath,
+                        startByte: 0,
+                        endByte: source.length,
+                        signature: 'middleware',
+                        summary: 'Next.js middleware',
+                        frameworkMeta: { nextjs_middleware: true },
+                    },
+                ];
+            }
+            default:
+                return [];
+        }
+    },
+    // ── Metadata enrichment ──────────────────────────────────────────────────────
+    /**
+     * Enrich component symbols emitted by the React adapter:
+     *
+     * - Components in pages/ → add route_path + nextjs_page: true
+     * - Components in app/**\/page.{tsx,jsx} → add route_path + nextjs_page: true
+     */
+    enrichMetadata(symbol) {
+        if (symbol.kind !== 'component')
+            return symbol;
+        const p = normalizePath(symbol.filePath);
+        // Pages Router component → enrich with route path
+        if (p.startsWith('pages/') && !p.startsWith('pages/api/')) {
+            const routePath = derivePageRouterPath(p);
+            return {
+                ...symbol,
+                frameworkMeta: {
+                    ...symbol.frameworkMeta,
+                    route_path: routePath,
+                    nextjs_page: true,
+                },
+            };
+        }
+        // App Router page component
+        if (p.startsWith('app/') && getCategory(p) === 'app-router-page') {
+            const routePath = deriveAppRouterPath(p);
+            return {
+                ...symbol,
+                frameworkMeta: {
+                    ...symbol.frameworkMeta,
+                    route_path: routePath,
+                    nextjs_page: true,
+                    router: 'app',
+                },
+            };
+        }
+        return symbol;
+    },
+};
+// ─── Self-registration ────────────────────────────────────────────────────────
+registerAdapter(nextjsAdapter);
+logger.debug("Adapter 'nextjs' registered");
+//# sourceMappingURL=nextjs.js.map

package/dist/adapters/nextjs.js.map

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

package/dist/adapters/nuxt.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Nuxt framework adapter.
+ *
+ * Handles Nuxt-specific .ts files (server routes, plugins, middleware,
+ * composables) and enriches page component symbols (emitted by the Vue adapter)
+ * with route path metadata via cross-adapter enrichMetadata.
+ *
+ * Detection: presence of nuxt.config.{ts,mts,js,mjs} in the project root.
+ *
+ * File categories handled:
+ *   server/api/...ts    → route symbol  (path derived from file path)
+ *   server/routes/...ts  → route symbol  (path at root, no /routes/ prefix)
+ *   plugins/...ts        → middleware symbol
+ *   middleware/...ts     → middleware symbol
+ *   composables/...ts    → (TS handler extracts; enrichMetadata adds auto_import)
+ *
+ * Cross-adapter enrichment (via enrichMetadata):
+ *   pages/...vue component symbols → add route_path + nuxt_page: true
+ *   composables/... symbols        → add nuxt_auto_import: true
+ */
+import type { FrameworkAdapter } from '../core/types.js';
+/**
+ * Derive the URL route path from a pages/ file path.
+ *   'pages/index.vue'          → '/'
+ *   'pages/about.vue'          → '/about'
+ *   'pages/blog/index.vue'     → '/blog'
+ *   'pages/blog/[slug].vue'    → '/blog/:slug'
+ *   'pages/[...catch].vue'     → '/*catch'
+ */
+export declare function derivePageRoutePath(filePath: string): string;
+/**
+ * Derive the URL route path and HTTP method from a server/ file path.
+ *
+ * server/api/users.get.ts      → { routePath: '/api/users', method: 'GET' }
+ * server/api/users.ts          → { routePath: '/api/users', method: null }
+ * server/api/[id].delete.ts    → { routePath: '/api/:id',  method: 'DELETE' }
+ * server/routes/health.ts      → { routePath: '/health',   method: null }
+ */
+export declare function deriveServerRoute(filePath: string): {
+    routePath: string;
+    method: string | null;
+};
+export declare const nuxtAdapter: FrameworkAdapter;
+//# sourceMappingURL=nuxt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nuxt.d.ts","sourceRoot":"","sources":["../../src/adapters/nuxt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,kBAAkB,CAAC;AA6B7E;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO5D;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAyBhG;AAgCD,eAAO,MAAM,WAAW,EAAE,gBAwIzB,CAAC"}