@flaid/devmap 0.2.0

package/dist/analyzers/detectors/frontendFeatureDetector.js

@@ -0,0 +1,269 @@
+import { buildReverseGraph } from "../graph/index.js";
+import { singularize } from "../analysis/extractors/fallbackExtractor.js";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/**
+ * Top-level page segments that aren't really a distinct product feature —
+ * either infrastructure (auth callbacks) or too generic to name a feature
+ * after on their own. Deliberately short: pages are usually meaningful
+ * (unlike the wider NON_RESOURCE_SEGMENTS list used for API-derived CRUD
+ * entities in capabilityDetector.ts) — "settings" or "profile" *are* real
+ * pages users navigate to, so they stay in.
+ */
+const NON_FEATURE_PAGE_SEGMENTS = new Set([
+    "auth", "oauth", "callback",
+    "api", "static", "assets", "public",
+]);
+// ---------------------------------------------------------------------------
+// Detector
+// ---------------------------------------------------------------------------
+/**
+ * detectFrontendPageFeatures — turn Next.js App/Pages Router page routes into
+ * features, independent of whether any database entity was found.
+ *
+ * Why this needs to be independent: entity-derived features (Prisma/SQL/
+ * route-hint) only run as a fallback chain that stops at the first non-empty
+ * source. A project with even one Prisma model (e.g. a NextAuth Session
+ * table) never reaches route-hint fallback, so page-only features like
+ * "Quran" or "Dzikir" — which have zero database presence — never surfaced
+ * at all. This runs unconditionally and merges alongside whatever else was
+ * found, so a mostly-frontend project doesn't get its features dominated by
+ * whatever thin backend evidence happens to exist.
+ */
+export function detectFrontendPageFeatures(routes, fileGraph) {
+    const pageRoutes = routes.filter((route) => route.kind === "page");
+    if (pageRoutes.length === 0)
+        return [];
+    const routesBySegment = groupBySegment(pageRoutes);
+    const reverseGraph = buildReverseGraph(fileGraph);
+    const features = [];
+    for (const [segment, segmentRoutes] of routesBySegment) {
+        const seedFiles = [...new Set(segmentRoutes.map((route) => route.file))].sort();
+        const ownedFiles = collectOwnedFiles(seedFiles, fileGraph, reverseGraph);
+        const name = singularize(segment);
+        features.push({
+            name,
+            purpose: `Frontend page${segmentRoutes.length > 1 ? "s" : ""} under "${segment}".`,
+            files: ownedFiles,
+            entryPoint: seedFiles[0],
+            entryPoints: seedFiles.slice(0, 2),
+            businessFlow: [],
+            searchTerms: [...new Set([segment.toLowerCase(), name.toLowerCase()])],
+            confidence: "medium",
+            evidence: ownedFiles
+        });
+    }
+    return features;
+}
+// ---------------------------------------------------------------------------
+// Internals
+// ---------------------------------------------------------------------------
+function groupBySegment(pageRoutes) {
+    const bySegment = new Map();
+    for (const route of pageRoutes) {
+        const segments = route.path.split("/").filter(Boolean);
+        const topSegment = segments[0];
+        if (!topSegment)
+            continue; // root "/" — no distinct feature name to derive
+        if (topSegment.startsWith("["))
+            continue; // dynamic-only, e.g. /[locale]
+        if (NON_FEATURE_PAGE_SEGMENTS.has(topSegment.toLowerCase()))
+            continue;
+        const list = bySegment.get(topSegment) ?? [];
+        list.push(route);
+        bySegment.set(topSegment, list);
+    }
+    return bySegment;
+}
+// ---------------------------------------------------------------------------
+// React Router (client-side routing)
+// ---------------------------------------------------------------------------
+/**
+ * Matches the common ways a path gets paired with a component reference in
+ * React Router — JSX `<Route path="..." element={<Foo />} />` / `component={Foo}`,
+ * and object/data-router configs `{ path: "...", element: <Foo /> }` /
+ * `{ path: "...", Component: Foo }`. Not a JSX/AST parser — same "common
+ * conventions, not full coverage" approach as the SQL table-name extraction.
+ * Assumes `path` appears before the element/component reference, which is
+ * the idiomatic order in real code; reversed ordering is a known v1 miss.
+ */
+const CLIENT_ROUTE_PATTERNS = [
+    /<Route\s+[^>]*?path=["'`]([^"'`]+)["'`][^>]*?element=\{<(\w+)/g,
+    /<Route\s+[^>]*?path=["'`]([^"'`]+)["'`][^>]*?component=\{?(\w+)/g,
+    /\{\s*path:\s*["'`]([^"'`]+)["'`][^}]*?element:\s*<(\w+)/g,
+    /\{\s*path:\s*["'`]([^"'`]+)["'`][^}]*?Component:\s*(\w+)/g,
+    // Vue Router — identifier form (component already imported above).
+    /\{\s*path:\s*["'`]([^"'`]+)["'`][^}]*?component:\s*(\w+)\s*[,}]/g,
+];
+// Vue Router — lazy import form: `component: () => import("./views/About.vue")`.
+// Captures the relative specifier instead of an identifier, so it resolves
+// through resolveRouteSpecifierFile rather than the identifier matcher.
+const LAZY_ROUTE_PATTERN = /\{\s*path:\s*["'`]([^"'`]+)["'`][^}]*?component:\s*\(\)\s*=>\s*import\(\s*["'`]([^"'`]+)["'`]\s*\)/g;
+// svelte-spa-router — object map form: `const routes = { '/about': About }`.
+// Too generic to trust on its own (any "string-key : identifier" object could
+// match), so it only runs on files that import svelte-spa-router.
+const SVELTE_SPA_ROUTER_PATTERN = /["'`](\/[^"'`]*)["'`]\s*:\s*(\w+)/g;
+const SVELTE_SPA_ROUTER_IMPORT = /from\s+["']svelte-spa-router["']|require\(\s*["']svelte-spa-router["']\s*\)/;
+function findClientRoutes(files) {
+    const routes = [];
+    for (const file of files) {
+        for (const pattern of CLIENT_ROUTE_PATTERNS) {
+            pattern.lastIndex = 0;
+            let match = pattern.exec(file.content);
+            while (match) {
+                routes.push({ path: match[1], component: match[2], definedIn: file.path });
+                match = pattern.exec(file.content);
+            }
+        }
+        LAZY_ROUTE_PATTERN.lastIndex = 0;
+        let match = LAZY_ROUTE_PATTERN.exec(file.content);
+        while (match) {
+            routes.push({ path: match[1], component: "", specifier: match[2], definedIn: file.path });
+            match = LAZY_ROUTE_PATTERN.exec(file.content);
+        }
+        if (SVELTE_SPA_ROUTER_IMPORT.test(file.content)) {
+            SVELTE_SPA_ROUTER_PATTERN.lastIndex = 0;
+            let svelteMatch = SVELTE_SPA_ROUTER_PATTERN.exec(file.content);
+            while (svelteMatch) {
+                routes.push({ path: svelteMatch[1], component: svelteMatch[2], definedIn: file.path });
+                svelteMatch = SVELTE_SPA_ROUTER_PATTERN.exec(file.content);
+            }
+        }
+    }
+    return routes;
+}
+/**
+ * A route only gives an identifier ("QuranPage"), not a file. Resolve it by
+ * checking what the defining file actually imports — the dependency graph
+ * already has that edge, so this is a lookup, not new import resolution.
+ */
+function resolveRouteComponentFile(route, fileGraph) {
+    const imported = fileGraph[route.definedIn] ?? [];
+    const target = route.component.toLowerCase();
+    return imported.find((file) => {
+        const stem = file.slice(file.lastIndexOf("/") + 1).replace(/\.[^/.]+$/, "");
+        return stem.toLowerCase() === target;
+    });
+}
+/**
+ * Vue Router's lazy form captures a relative specifier ("./views/About.vue"),
+ * not an identifier — the graph's resolved imports won't match it directly.
+ * Resolve the specifier against the defining file's folder and match the
+ * scanned file list, covering explicit .vue extensions and omitted ones.
+ */
+function resolveRouteSpecifierFile(route, files) {
+    const available = new Set(files.map((file) => file.path));
+    const baseParts = route.definedIn.split("/");
+    baseParts.pop();
+    const normalized = normalizeRoutePath([...baseParts, route.specifier ?? ""].join("/"));
+    const candidates = [
+        normalized,
+        `${normalized}.vue`,
+        `${normalized}.ts`,
+        `${normalized}.tsx`,
+        `${normalized}.js`,
+        `${normalized}.jsx`,
+        `${normalized}/index.vue`,
+        `${normalized}/index.ts`,
+        `${normalized}/index.js`
+    ];
+    return candidates.find((candidate) => available.has(candidate));
+}
+function normalizeRoutePath(path) {
+    const parts = [];
+    for (const part of path.split("/")) {
+        if (part === "." || part === "") {
+            continue;
+        }
+        if (part === "..") {
+            parts.pop();
+            continue;
+        }
+        parts.push(part);
+    }
+    return parts.join("/");
+}
+/**
+ * detectClientRouteFeatures — same purpose and output shape as
+ * detectFrontendPageFeatures, for SPAs with no file-based routing (Vite +
+ * React Router). Route paths come from parsing route definitions instead of
+ * folder conventions; ownership uses the exact same reverse-graph rule.
+ */
+export function detectClientRouteFeatures(files, fileGraph) {
+    const routes = findClientRoutes(files);
+    if (routes.length === 0)
+        return [];
+    const bySegment = new Map();
+    for (const route of routes) {
+        const segments = route.path.split("/").filter(Boolean);
+        const topSegment = segments[0];
+        if (!topSegment || topSegment.startsWith(":") || topSegment.startsWith("*"))
+            continue;
+        if (NON_FEATURE_PAGE_SEGMENTS.has(topSegment.toLowerCase()))
+            continue;
+        const resolvedFile = route.specifier
+            ? resolveRouteSpecifierFile(route, files)
+            : resolveRouteComponentFile(route, fileGraph);
+        if (!resolvedFile)
+            continue;
+        const seeds = bySegment.get(topSegment) ?? [];
+        if (!seeds.includes(resolvedFile))
+            seeds.push(resolvedFile);
+        bySegment.set(topSegment, seeds);
+    }
+    const reverseGraph = buildReverseGraph(fileGraph);
+    const features = [];
+    for (const [segment, seedFiles] of bySegment) {
+        if (seedFiles.length === 0)
+            continue;
+        const ownedFiles = collectOwnedFiles(seedFiles, fileGraph, reverseGraph);
+        const name = singularize(segment);
+        features.push({
+            name,
+            purpose: `Client-side route${seedFiles.length > 1 ? "s" : ""} under "${segment}".`,
+            files: ownedFiles,
+            entryPoint: seedFiles[0],
+            entryPoints: seedFiles.slice(0, 2),
+            businessFlow: [],
+            searchTerms: [...new Set([segment.toLowerCase(), name.toLowerCase()])],
+            confidence: "medium",
+            evidence: ownedFiles
+        });
+    }
+    return features;
+}
+/**
+ * collectOwnedFiles — seed files plus every file reachable from them whose
+ * *every* referrer is also within that reachable set. A component (or
+ * store, or any other file) imported by this route/page and nothing else is
+ * "owned"; a file also imported by a different page or feature is shared
+ * and stays out — false-negative (feature looks smaller than it is) over
+ * false-positive (feature claims a shared file it doesn't really own).
+ */
+function collectOwnedFiles(seedFiles, graph, reverseGraph) {
+    const reachable = new Set(seedFiles);
+    const queue = [...seedFiles];
+    while (queue.length > 0) {
+        const current = queue.shift();
+        for (const next of graph[current] ?? []) {
+            if (!reachable.has(next)) {
+                reachable.add(next);
+                queue.push(next);
+            }
+        }
+    }
+    const seedSet = new Set(seedFiles);
+    const owned = new Set(seedFiles);
+    for (const file of reachable) {
+        if (seedSet.has(file))
+            continue;
+        const referrers = reverseGraph[file] ?? [];
+        const hasExternalReferrer = referrers.some((referrer) => !reachable.has(referrer));
+        if (!hasExternalReferrer) {
+            owned.add(file);
+        }
+    }
+    return [...owned].sort();
+}
+//# sourceMappingURL=frontendFeatureDetector.js.map

package/dist/analyzers/detectors/frontendFeatureDetector.js.map

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

package/dist/analyzers/detectors/index.d.ts

@@ -0,0 +1,11 @@
+export { detectFramework, detectFrameworks, } from "./frameworkDetector.js";
+export type { Framework, DetectedFramework, } from "./frameworkDetector.js";
+export { detectRoutes, } from "./routeDetector.js";
+export type { RouteInfo, } from "./routeDetector.js";
+export { detectExternalServices, } from "./serviceDetector.js";
+export { detectDatabase, } from "./databaseDetector.js";
+export type { DatabaseInfo, } from "./databaseDetector.js";
+export { detectCapabilities, } from "./capabilityDetector.js";
+export type { CapabilityKind, CapabilityInfo, } from "./capabilityDetector.js";
+export { detectFrontendPageFeatures, detectClientRouteFeatures, } from "./frontendFeatureDetector.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/analyzers/detectors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analyzers/detectors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,SAAS,EACT,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,SAAS,GACV,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,YAAY,GACb,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,cAAc,EACd,cAAc,GACf,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,8BAA8B,CAAC"}

package/dist/analyzers/detectors/index.js

@@ -0,0 +1,7 @@
+export { detectFramework, detectFrameworks, } from "./frameworkDetector.js";
+export { detectRoutes, } from "./routeDetector.js";
+export { detectExternalServices, } from "./serviceDetector.js";
+export { detectDatabase, } from "./databaseDetector.js";
+export { detectCapabilities, } from "./capabilityDetector.js";
+export { detectFrontendPageFeatures, detectClientRouteFeatures, } from "./frontendFeatureDetector.js";
+//# sourceMappingURL=index.js.map

package/dist/analyzers/detectors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analyzers/detectors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAMhC,OAAO,EACL,YAAY,GACb,MAAM,oBAAoB,CAAC;AAK5B,OAAO,EACL,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,cAAc,GACf,MAAM,uBAAuB,CAAC;AAK/B,OAAO,EACL,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAMjC,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,8BAA8B,CAAC"}

package/dist/analyzers/detectors/nestRouteDetector.d.ts

@@ -0,0 +1,13 @@
+import type { ScannedFile } from "../analysis/index.js";
+import type { RouteInfo } from "./routeDetector.js";
+/**
+ * detectNestRoutes — NestJS controllers are decorator + class based, so flat
+ * per-line regex cannot associate a @Get(':id') with the @Controller('users')
+ * that scopes it. ts-morph gives per-class/method decorator scope for free.
+ *
+ * Known v1 limitations (from update5.md):
+ * - @Controller({ path: '...' }) object form is skipped (prefix becomes "").
+ * - app.setGlobalPrefix('api') is not composed into route paths.
+ */
+export declare function detectNestRoutes(files: ScannedFile[]): RouteInfo[];
+//# sourceMappingURL=nestRouteDetector.d.ts.map

package/dist/analyzers/detectors/nestRouteDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nestRouteDetector.d.ts","sourceRoot":"","sources":["../../../src/analyzers/detectors/nestRouteDetector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAepD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,SAAS,EAAE,CA4DlE"}

package/dist/analyzers/detectors/nestRouteDetector.js

@@ -0,0 +1,69 @@
+import { Project, SyntaxKind } from "ts-morph";
+const ROUTE_DECORATORS = new Set([
+    "Get",
+    "Post",
+    "Put",
+    "Patch",
+    "Delete",
+    "Options",
+    "Head",
+    "All"
+]);
+const ALL_HTTP_METHODS = ["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS", "HEAD"];
+/**
+ * detectNestRoutes — NestJS controllers are decorator + class based, so flat
+ * per-line regex cannot associate a @Get(':id') with the @Controller('users')
+ * that scopes it. ts-morph gives per-class/method decorator scope for free.
+ *
+ * Known v1 limitations (from update5.md):
+ * - @Controller({ path: '...' }) object form is skipped (prefix becomes "").
+ * - app.setGlobalPrefix('api') is not composed into route paths.
+ */
+export function detectNestRoutes(files) {
+    // Cheap pre-filter before any ts-morph parse — most scans have no controllers.
+    const candidates = files.filter((file) => /\.[cm]?[jt]s$/.test(file.path) && file.content.includes("@Controller"));
+    if (candidates.length === 0) {
+        return [];
+    }
+    const project = new Project({ useInMemoryFileSystem: true });
+    const routes = [];
+    for (const file of candidates) {
+        let sourceFile;
+        try {
+            sourceFile = project.createSourceFile(file.path, file.content);
+        }
+        catch {
+            continue; // one broken controller must not crash the whole scan
+        }
+        for (const cls of sourceFile.getClasses()) {
+            const controllerDecorator = cls.getDecorator("Controller");
+            if (!controllerDecorator) {
+                continue;
+            }
+            const prefixArg = controllerDecorator.getArguments()[0];
+            const prefix = prefixArg?.asKind(SyntaxKind.StringLiteral)?.getLiteralText() ?? "";
+            for (const method of cls.getMethods()) {
+                const routeDecorator = method
+                    .getDecorators()
+                    .find((decorator) => ROUTE_DECORATORS.has(decorator.getName()));
+                if (!routeDecorator) {
+                    continue;
+                }
+                const pathArg = routeDecorator.getArguments()[0];
+                const subPath = pathArg?.asKind(SyntaxKind.StringLiteral)?.getLiteralText() ?? "";
+                const decoratorName = routeDecorator.getName().toUpperCase();
+                // @All() matches every HTTP method — expand instead of inventing a
+                // placeholder value.
+                const methods = decoratorName === "ALL" ? ALL_HTTP_METHODS : [decoratorName];
+                routes.push({
+                    path: `/${[prefix, subPath].filter(Boolean).join("/")}`.replace(/\/+/g, "/"),
+                    file: file.path,
+                    kind: "api",
+                    methods
+                });
+            }
+        }
+    }
+    return routes.sort((left, right) => left.path.localeCompare(right.path) || left.file.localeCompare(right.file));
+}
+//# sourceMappingURL=nestRouteDetector.js.map

package/dist/analyzers/detectors/nestRouteDetector.js.map

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

package/dist/analyzers/detectors/routeDetector.d.ts

@@ -0,0 +1,22 @@
+import type { ScannedFile } from "../analysis/index.js";
+import type { DetectedFramework } from "./frameworkDetector.js";
+export type RouteInfo = {
+    path: string;
+    file: string;
+    kind: "page" | "api";
+    methods?: string[];
+};
+/**
+ * detectRoutes — run every detector whose framework was detected, then merge
+ * the results. A project with a Next.js frontend AND an Express backend in a
+ * single scan now yields routes from BOTH sides instead of first-match-wins.
+ *
+ * Each per-framework detector stays isolated (they already filter by their own
+ * file patterns), so running several at once is safe — they don't collide
+ * because they look at different files.
+ *
+ * `graph` (optional) lets the Express detector resolve routers mounted across
+ * files so mount prefixes compose with the sub-paths they wrap.
+ */
+export declare function detectRoutes(files: ScannedFile[], frameworks: DetectedFramework[], graph?: Record<string, string[]>): RouteInfo[];
+//# sourceMappingURL=routeDetector.d.ts.map

package/dist/analyzers/detectors/routeDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeDetector.d.ts","sourceRoot":"","sources":["../../../src/analyzers/detectors/routeDetector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAIhE,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,WAAW,EAAE,EACpB,UAAU,EAAE,iBAAiB,EAAE,EAC/B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAC/B,SAAS,EAAE,CAgCb"}