next-arch-map 0.1.13 → 0.1.15

package/dist/analyzers/endpointsToDb.js

@@ -17,41 +17,49 @@ export async function analyzeEndpointsToDb(options) {
     const seenRouteFiles = new Set();
     for (const scanRoot of scanRoots) {
         for (const filePath of walkDirectory(scanRoot)) {
-            if (seenRouteFiles.has(filePath) || isIgnoredSourceFile(filePath) || !isRouteHandlerFile(filePath)) {
+            if (seenRouteFiles.has(filePath) ||
+                isIgnoredSourceFile(filePath) ||
+                !isRouteHandlerFile(filePath)) {
                 continue;
             }
             seenRouteFiles.add(filePath);
-            const endpointPath = getEndpointRouteFromFile(scanRoot, filePath);
-            const { availableMethods, dbUsageByModel } = analyzeEndpoint(filePath, projectRoot, moduleCache, sourceFileCache, dbClientIdentifiers);
-            const endpointNode = ensureNode(nodes, nodeIds, buildEndpointNode(endpointPath, filePath));
-            const handlerMethods = availableMethods.size > 0 ? [...availableMethods] : [undefined];
-            for (const methodName of handlerMethods) {
-                const handlerNode = ensureNode(nodes, nodeIds, buildHandlerNode(endpointPath, filePath, methodName));
-                const edgeKey = buildEdgeKey(endpointNode.id, handlerNode.id, "endpoint-handler");
-                if (edgeKeys.has(edgeKey)) {
-                    continue;
+            try {
+                const endpointPath = getEndpointRouteFromFile(scanRoot, filePath);
+                const { availableMethods, dbUsageByModel } = analyzeEndpoint(filePath, projectRoot, moduleCache, sourceFileCache, dbClientIdentifiers);
+                const endpointNode = ensureNode(nodes, nodeIds, buildEndpointNode(endpointPath, filePath));
+                const handlerMethods = availableMethods.size > 0 ? [...availableMethods] : [undefined];
+                for (const methodName of handlerMethods) {
+                    const handlerNode = ensureNode(nodes, nodeIds, buildHandlerNode(endpointPath, filePath, methodName));
+                    const edgeKey = buildEdgeKey(endpointNode.id, handlerNode.id, "endpoint-handler");
+                    if (edgeKeys.has(edgeKey)) {
+                        continue;
+                    }
+                    edgeKeys.add(edgeKey);
+                    edges.push({
+                        from: endpointNode.id,
+                        to: handlerNode.id,
+                        kind: "endpoint-handler",
+                        meta: methodName ? { method: methodName } : undefined,
+                    });
                 }
-                edgeKeys.add(edgeKey);
-                edges.push({
-                    from: endpointNode.id,
-                    to: handlerNode.id,
-                    kind: "endpoint-handler",
-                    meta: methodName ? { method: methodName } : undefined,
-                });
-            }
-            for (const [modelName, dbUsage] of dbUsageByModel) {
-                const dbNode = ensureNode(nodes, nodeIds, buildDbNode(modelName, dbUsage.filePath));
-                const edgeKey = buildEdgeKey(endpointNode.id, dbNode.id, "endpoint-db");
-                if (edgeKeys.has(edgeKey)) {
-                    continue;
+                for (const [modelName, dbUsage] of dbUsageByModel) {
+                    const dbNode = ensureNode(nodes, nodeIds, buildDbNode(modelName, dbUsage.filePath));
+                    const edgeKey = buildEdgeKey(endpointNode.id, dbNode.id, "endpoint-db");
+                    if (edgeKeys.has(edgeKey)) {
+                        continue;
+                    }
+                    edgeKeys.add(edgeKey);
+                    edges.push({
+                        from: endpointNode.id,
+                        to: dbNode.id,
+                        kind: "endpoint-db",
+                        meta: dbUsage.actionName ? { action: dbUsage.actionName } : undefined,
+                    });
                 }
-                edgeKeys.add(edgeKey);
-                edges.push({
-                    from: endpointNode.id,
-                    to: dbNode.id,
-                    kind: "endpoint-db",
-                    meta: dbUsage.actionName ? { action: dbUsage.actionName } : undefined,
-                });
+            }
+            catch (error) {
+                const relative = path.relative(projectRoot, filePath);
+                console.warn(`Warning: skipping ${relative}: ${error instanceof Error ? error.message : error}`);
             }
         }
     }
@@ -219,7 +227,14 @@ function getModuleInfo(filePath, state) {
     }
     const sourceFile = getSourceFile(filePath, state.sourceFileCache);
     if (!sourceFile) {
-        throw new Error(`Could not parse ${path.relative(state.projectRoot, filePath)}.`);
+        const emptyModuleInfo = {
+            localDeclarations: new Map(),
+            importsByLocalName: new Map(),
+            exportsByName: new Map(),
+        };
+        console.warn(`Warning: could not parse ${path.relative(state.projectRoot, filePath)}, skipping.`);
+        state.moduleCache.set(filePath, emptyModuleInfo);
+        return emptyModuleInfo;
     }
     const localDeclarations = new Map();
     const importsByLocalName = new Map();
@@ -341,8 +356,10 @@ function getFunctionBodyNode(node) {
     return node.body;
 }
 function hasExportModifier(node) {
-    return ts.getModifiers(node)?.some((modifier) => modifier.kind === ts.SyntaxKind.ExportKeyword) ?? false;
+    return (ts.getModifiers(node)?.some((modifier) => modifier.kind === ts.SyntaxKind.ExportKeyword) ??
+        false);
 }
 function hasDefaultModifier(node) {
-    return ts.getModifiers(node)?.some((modifier) => modifier.kind === ts.SyntaxKind.DefaultKeyword) ?? false;
+    return (ts.getModifiers(node)?.some((modifier) => modifier.kind === ts.SyntaxKind.DefaultKeyword) ??
+        false);
 }

package/dist/analyzers/pagesToEndpoints.js

@@ -1,3 +1,4 @@
+import path from "node:path";
 import ts from "typescript";
 import { buildActionNode, buildEdgeKey, buildEndpointNode, buildPageNode, collectStringConstants, ensureNode, getExistingDirectories, getPageRouteFromFile, getSourceFile, getStringLiteralValue, isIgnoredSourceFile, isPageFile, resolveProjectRoot, walkDirectory, } from "../utils.js";
 const DEFAULT_APP_DIRS = ["app", "src/app"];
@@ -25,59 +26,65 @@ export async function analyzePagesToEndpoints(options) {
             if (isIgnoredSourceFile(filePath)) {
                 continue;
             }
-            const sourceFile = getSourceFile(filePath, sourceFileCache);
-            if (!sourceFile) {
-                continue;
-            }
-            const httpCalls = collectHttpCalls(sourceFile, httpClientIdentifiers, httpClientMethods);
-            // Non-page files (route handlers, layouts, helpers) under app/ only
-            // contribute endpoint nodes without creating fake page flows.
-            if (!isPageFile(filePath)) {
-                for (const call of httpCalls) {
-                    ensureNode(nodes, nodeIds, buildEndpointNode(call.endpoint, filePath));
+            try {
+                const sourceFile = getSourceFile(filePath, sourceFileCache);
+                if (!sourceFile) {
+                    continue;
                 }
-                continue;
-            }
-            const route = getPageRouteFromFile(appDir, filePath);
-            ensureNode(nodes, nodeIds, buildPageNode(route, filePath));
-            for (const call of httpCalls) {
-                const nextCallIndex = (callIndexByRoute.get(route) ?? 0) + 1;
-                callIndexByRoute.set(route, nextCallIndex);
-                const actionContext = inferActionContext(call.node, sourceFile, nextCallIndex);
-                const actionId = allocateActionId(route, actionContext.id, actionIdCountByRoute);
-                const pageNode = ensureNode(nodes, nodeIds, buildPageNode(route, filePath));
-                const actionNode = ensureNode(nodes, nodeIds, buildActionNode(route, actionId, filePath, actionContext.meta));
-                const endpointNode = ensureNode(nodes, nodeIds, buildEndpointNode(call.endpoint, filePath));
-                const pageActionKey = buildEdgeKey(pageNode.id, actionNode.id, "page-action");
-                if (!edgeKeys.has(pageActionKey)) {
-                    edgeKeys.add(pageActionKey);
-                    edges.push({
-                        from: pageNode.id,
-                        to: actionNode.id,
-                        kind: "page-action",
-                    });
+                const httpCalls = collectHttpCalls(sourceFile, httpClientIdentifiers, httpClientMethods);
+                // Non-page files (route handlers, layouts, helpers) under app/ only
+                // contribute endpoint nodes without creating fake page flows.
+                if (!isPageFile(filePath)) {
+                    for (const call of httpCalls) {
+                        ensureNode(nodes, nodeIds, buildEndpointNode(call.endpoint, filePath));
+                    }
+                    continue;
                 }
-                const actionEndpointKey = buildEdgeKey(actionNode.id, endpointNode.id, "action-endpoint");
-                if (!edgeKeys.has(actionEndpointKey)) {
-                    edgeKeys.add(actionEndpointKey);
+                const route = getPageRouteFromFile(appDir, filePath);
+                ensureNode(nodes, nodeIds, buildPageNode(route, filePath));
+                for (const call of httpCalls) {
+                    const nextCallIndex = (callIndexByRoute.get(route) ?? 0) + 1;
+                    callIndexByRoute.set(route, nextCallIndex);
+                    const actionContext = inferActionContext(call.node, sourceFile, nextCallIndex);
+                    const actionId = allocateActionId(route, actionContext.id, actionIdCountByRoute);
+                    const pageNode = ensureNode(nodes, nodeIds, buildPageNode(route, filePath));
+                    const actionNode = ensureNode(nodes, nodeIds, buildActionNode(route, actionId, filePath, actionContext.meta));
+                    const endpointNode = ensureNode(nodes, nodeIds, buildEndpointNode(call.endpoint, filePath));
+                    const pageActionKey = buildEdgeKey(pageNode.id, actionNode.id, "page-action");
+                    if (!edgeKeys.has(pageActionKey)) {
+                        edgeKeys.add(pageActionKey);
+                        edges.push({
+                            from: pageNode.id,
+                            to: actionNode.id,
+                            kind: "page-action",
+                        });
+                    }
+                    const actionEndpointKey = buildEdgeKey(actionNode.id, endpointNode.id, "action-endpoint");
+                    if (!edgeKeys.has(actionEndpointKey)) {
+                        edgeKeys.add(actionEndpointKey);
+                        edges.push({
+                            from: actionNode.id,
+                            to: endpointNode.id,
+                            kind: "action-endpoint",
+                            meta: call.method ? { method: call.method } : undefined,
+                        });
+                    }
+                    const edgeKey = buildEdgeKey(pageNode.id, endpointNode.id, "page-endpoint");
+                    if (edgeKeys.has(edgeKey)) {
+                        continue;
+                    }
+                    edgeKeys.add(edgeKey);
                     edges.push({
-                        from: actionNode.id,
+                        from: pageNode.id,
                         to: endpointNode.id,
-                        kind: "action-endpoint",
+                        kind: "page-endpoint",
                         meta: call.method ? { method: call.method } : undefined,
                     });
                 }
-                const edgeKey = buildEdgeKey(pageNode.id, endpointNode.id, "page-endpoint");
-                if (edgeKeys.has(edgeKey)) {
-                    continue;
-                }
-                edgeKeys.add(edgeKey);
-                edges.push({
-                    from: pageNode.id,
-                    to: endpointNode.id,
-                    kind: "page-endpoint",
-                    meta: call.method ? { method: call.method } : undefined,
-                });
+            }
+            catch (error) {
+                const relative = path.relative(projectRoot, filePath);
+                console.warn(`Warning: skipping ${relative}: ${error instanceof Error ? error.message : error}`);
             }
         }
     }
@@ -86,12 +93,18 @@ export async function analyzePagesToEndpoints(options) {
             if (isIgnoredSourceFile(filePath)) {
                 continue;
             }
-            const sourceFile = getSourceFile(filePath, sourceFileCache);
-            if (!sourceFile) {
-                continue;
+            try {
+                const sourceFile = getSourceFile(filePath, sourceFileCache);
+                if (!sourceFile) {
+                    continue;
+                }
+                for (const call of collectHttpCalls(sourceFile, httpClientIdentifiers, httpClientMethods)) {
+                    ensureNode(nodes, nodeIds, buildEndpointNode(call.endpoint, filePath));
+                }
             }
-            for (const call of collectHttpCalls(sourceFile, httpClientIdentifiers, httpClientMethods)) {
-                ensureNode(nodes, nodeIds, buildEndpointNode(call.endpoint, filePath));
+            catch (error) {
+                const relative = path.relative(projectRoot, filePath);
+                console.warn(`Warning: skipping ${relative}: ${error instanceof Error ? error.message : error}`);
             }
         }
     }
@@ -263,12 +276,15 @@ function isTopLevelNamedFunctionLike(node, sourceFile) {
     return false;
 }
 function getFunctionLikeName(node) {
-    if ((ts.isFunctionDeclaration(node) || ts.isFunctionExpression(node) || ts.isMethodDeclaration(node)) &&
+    if ((ts.isFunctionDeclaration(node) ||
+        ts.isFunctionExpression(node) ||
+        ts.isMethodDeclaration(node)) &&
         node.name &&
         ts.isIdentifier(node.name)) {
         return node.name.text;
     }
-    if ((ts.isArrowFunction(node) || ts.isFunctionExpression(node)) && ts.isVariableDeclaration(node.parent)) {
+    if ((ts.isArrowFunction(node) || ts.isFunctionExpression(node)) &&
+        ts.isVariableDeclaration(node.parent)) {
         return ts.isIdentifier(node.parent.name) ? node.parent.name.text : undefined;
     }
     return undefined;

package/dist/analyzers/pagesToUi.js

@@ -24,21 +24,27 @@ export async function analyzePagesToUi(options) {
             if (!isPageFile(filePath)) {
                 continue;
             }
-            const route = getPageRouteFromFile(appDir, filePath);
-            const pageNode = ensureNode(nodes, nodeIds, buildPageNode(route, filePath));
-            const components = collectUiComponentUsages(filePath, projectRoot, uiPathMatchers);
-            for (const component of components) {
-                const uiNode = ensureNode(nodes, nodeIds, buildUiNode(component.componentName, component.filePath));
-                const edgeKey = buildEdgeKey(pageNode.id, uiNode.id, "page-ui");
-                if (edgeKeys.has(edgeKey)) {
-                    continue;
+            try {
+                const route = getPageRouteFromFile(appDir, filePath);
+                const pageNode = ensureNode(nodes, nodeIds, buildPageNode(route, filePath));
+                const components = collectUiComponentUsages(filePath, projectRoot, uiPathMatchers);
+                for (const component of components) {
+                    const uiNode = ensureNode(nodes, nodeIds, buildUiNode(component.componentName, component.filePath));
+                    const edgeKey = buildEdgeKey(pageNode.id, uiNode.id, "page-ui");
+                    if (edgeKeys.has(edgeKey)) {
+                        continue;
+                    }
+                    edgeKeys.add(edgeKey);
+                    edges.push({
+                        from: pageNode.id,
+                        to: uiNode.id,
+                        kind: "page-ui",
+                    });
                 }
-                edgeKeys.add(edgeKey);
-                edges.push({
-                    from: pageNode.id,
-                    to: uiNode.id,
-                    kind: "page-ui",
-                });
+            }
+            catch (error) {
+                const relative = path.relative(projectRoot, filePath);
+                console.warn(`Warning: skipping ${relative}: ${error instanceof Error ? error.message : error}`);
             }
         }
     }

package/dist/diff.js

@@ -1,6 +1,6 @@
 import { buildEdgeKey } from "./utils.js";
 function nodeEqual(a, b) {
-    return a.type === b.type && a.label === b.label && JSON.stringify(a.meta) === JSON.stringify(b.meta);
+    return (a.type === b.type && a.label === b.label && JSON.stringify(a.meta) === JSON.stringify(b.meta));
 }
 function edgeEqual(a, b) {
     return JSON.stringify(a.meta) === JSON.stringify(b.meta);

package/dist/index.d.ts

@@ -17,4 +17,4 @@ export { analyzePagesToEndpoints } from "./analyzers/pagesToEndpoints.js";
 export { analyzeEndpointsToDb } from "./analyzers/endpointsToDb.js";
 export { analyzePagesToUi } from "./analyzers/pagesToUi.js";
 export { mergeGraphs, mergePartial } from "./merge.js";
-export { getDbModelsForPage, getEndpointsForPage, getPagesForDbModel, } from "./query.js";
+export { getDbModelsForPage, getEndpointsForPage, getPagesForDbModel } from "./query.js";

package/dist/index.js

@@ -27,4 +27,4 @@ export { analyzePagesToEndpoints } from "./analyzers/pagesToEndpoints.js";
 export { analyzeEndpointsToDb } from "./analyzers/endpointsToDb.js";
 export { analyzePagesToUi } from "./analyzers/pagesToUi.js";
 export { mergeGraphs, mergePartial } from "./merge.js";
-export { getDbModelsForPage, getEndpointsForPage, getPagesForDbModel, } from "./query.js";
+export { getDbModelsForPage, getEndpointsForPage, getPagesForDbModel } from "./query.js";

package/dist/merge.js

@@ -1,6 +1,9 @@
 import { buildEdgeKey, mergeEdge, mergeNode } from "./utils.js";
 export function mergeGraphs(graphs) {
-    return graphs.reduce((accumulator, graph) => mergePartial(accumulator, graph), { nodes: [], edges: [] });
+    return graphs.reduce((accumulator, graph) => mergePartial(accumulator, graph), {
+        nodes: [],
+        edges: [],
+    });
 }
 export function mergePartial(base, additions) {
     const nodesById = new Map();

package/dist/serve.js

@@ -3,7 +3,7 @@ import path from "node:path";
 import chokidar from "chokidar";
 import { analyzeProject } from "./index.js";
 import { diffGraphs } from "./diff.js";
-import { getDbModelsForPage, getEndpointsForPage, getPagesForDbModel, } from "./query.js";
+import { getDbModelsForPage, getEndpointsForPage, getPagesForDbModel } from "./query.js";
 export async function serve(options) {
     const projectRoot = path.resolve(options.projectRoot);
     const port = options.port ?? 4321;

package/dist/utils.js

@@ -74,8 +74,7 @@ export function getEndpointRouteFromFile(scanRoot, filePath) {
     if (!ROUTE_FILE_PATTERN.test(fileName)) {
         return prefixedSegments.length === 0 ? "/" : `/${prefixedSegments.join("/")}`;
     }
-    if (prefixedSegments.length > 1 &&
-        prefixedSegments[0] === prefixedSegments[1]) {
+    if (prefixedSegments.length > 1 && prefixedSegments[0] === prefixedSegments[1]) {
         prefixedSegments.shift();
     }
     return prefixedSegments.length === 0 ? "/" : `/${prefixedSegments.join("/")}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "next-arch-map",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "Static analyzer that builds a multi-layer architecture graph for Next.js-style apps.",
   "type": "module",
   "bin": {
@@ -26,6 +26,9 @@
     "build": "tsc -p tsconfig.json",
     "check": "tsc --noEmit -p tsconfig.json",
     "test": "vitest run",
+    "lint": "eslint src/ tests/",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\"",
     "dev": "node dist/cli.js dev"
   },
   "keywords": [
@@ -45,7 +48,12 @@
     "typescript": "^5.8.2"
   },
   "devDependencies": {
+    "@eslint/js": "^10.0.1",
     "@types/node": "^20.19.0",
+    "eslint": "^10.0.3",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.8.1",
+    "typescript-eslint": "^8.57.0",
     "vitest": "^4.1.0"
   }
 }

package/viewer/src/App.tsx

@@ -98,7 +98,7 @@ function buildEdgeKey(from: string, to: string, kind: EdgeKind): string {
 export function App() {
   const [graph, setGraph] = useState<Graph | null>(null);
   const [graphDiff, setGraphDiff] = useState<GraphDiff | null>(null);
-  const [useServer, setUseServer] = useState(false);
+  const [useServer, setUseServer] = useState(true);
   const [serverUrl, setServerUrl] = useState("http://localhost:4321");
   const [focusedPageRoute, setFocusedPageRoute] = useState<string | null>(null);
   const [queryRoute, setQueryRoute] = useState("/dashboard");