codegraph-java 0.1.0

package/dist/resolution/frameworks/goframe.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * GoFrame Framework Resolver (route metadata) — issue #747.
+ *
+ * GoFrame's "standard router" binds routes reflectively, so there is no literal
+ * path string at a `.GET("/x", handler)` call site and no static edge from a
+ * route to the controller method that serves it. The structural facts live in
+ * two places, joined only at runtime by GoFrame:
+ *
+ *   // api/user/v1/user_sign_in.go — the route lives in a struct tag on the request type
+ *   type SignInReq struct {
+ *       g.Meta `path:"/user/sign-in" method:"post" tags:"UserService" summary:"…"`
+ *       …
+ *   }
+ *   // internal/controller/user/user_v1_sign_in.go — the handler takes *that* request type
+ *   func (c *ControllerV1) SignIn(ctx context.Context, req *v1.SignInReq) (res *v1.SignInRes, err error)
+ *   // internal/cmd/cmd.go — reflective binding (no path, no handler name)
+ *   group.Bind(user.NewV1())
+ *
+ * This resolver handles the FIRST half: it reads the `g.Meta` struct tag on a
+ * request type into a `route` node (`POST /user/sign-in`). The route → handler
+ * EDGE is the genuinely reflective part — the method name is NOT derivable from
+ * the request type (`DeptSearchReq` is served by `List`, `DeptAddReq` by `Add`),
+ * so the only reliable join is the request type appearing in the method's
+ * parameter signature. That whole-graph join is done by the companion
+ * `goframeRouteEdges` synthesizer, which reads the request type back out of the
+ * route node's qualifiedName.
+ *
+ * Honesty note: the route node carries the `g.Meta` path verbatim. The group
+ * prefix from `s.Group("/api", …)` / nested `group.Group("/v1", …)` is applied
+ * by reflective `Bind` at runtime and is deliberately NOT reconstructed here —
+ * the discriminating, structural part is the per-route path + method.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.goframeResolver = exports.GOFRAME_ROUTE_MARKER = void 0;
+const strip_comments_1 = require("../strip-comments");
+/**
+ * A request type carrying a routable `g.Meta` tag. `g.Meta` is, by GoFrame
+ * convention, the first embedded field of the struct, so anchoring on
+ * `struct { g.Meta `…` }` is both precise and cheap. Response types embed
+ * `g.Meta` too but tag it `mime:"…"` with no `path:` — the path requirement
+ * below filters them out.
+ */
+const GOFRAME_META_RE = /\btype\s+([A-Z]\w*)\s+struct\s*\{\s*g\.Meta\s+`([^`]*)`/g;
+const META_PATH_RE = /\bpath:"([^"]+)"/;
+const META_METHOD_RE = /\bmethod:"([^"]+)"/;
+const GO_PACKAGE_RE = /^\s*package\s+(\w+)/m;
+/** Marker embedded in a route node's qualifiedName so the synthesizer can read
+ *  back the request type to join on. The value after it is the package-qualified
+ *  request type (`cash.ListReq`) — the package disambiguates the many identical
+ *  bare names (`ListReq`, `GetReq`) a large app defines, one per module. Falls
+ *  back to the bare type when no `package` declaration is found. */
+exports.GOFRAME_ROUTE_MARKER = '::goframe-route:';
+exports.goframeResolver = {
+    name: 'goframe',
+    languages: ['go'],
+    detect(context) {
+        const goMod = context.readFile('go.mod');
+        // GoFrame is `github.com/gogf/gf` (v1) or `github.com/gogf/gf/v2` (v2).
+        return !!goMod && goMod.includes('github.com/gogf/gf');
+    },
+    extract(filePath, content) {
+        if (!filePath.endsWith('.go'))
+            return { nodes: [], references: [] };
+        // Cheap reject: the file must mention g.Meta at all.
+        if (!content.includes('g.Meta'))
+            return { nodes: [], references: [] };
+        const nodes = [];
+        const now = Date.now();
+        const safe = (0, strip_comments_1.stripCommentsForRegex)(content, 'go');
+        const pkg = GO_PACKAGE_RE.exec(safe)?.[1];
+        GOFRAME_META_RE.lastIndex = 0;
+        let match;
+        while ((match = GOFRAME_META_RE.exec(safe)) !== null) {
+            const [, requestType, tag] = match;
+            const pathMatch = META_PATH_RE.exec(tag);
+            if (!pathMatch)
+                continue; // response `g.Meta `mime:…`` and other non-route metadata
+            const routePath = pathMatch[1];
+            const methodMatch = META_METHOD_RE.exec(tag);
+            // GoFrame defaults to all methods when `method:` is omitted.
+            const method = methodMatch ? methodMatch[1].toUpperCase() : 'ANY';
+            const line = safe.slice(0, match.index).split('\n').length;
+            // The handler's signature qualifies the request type with its package
+            // (`req *cash.ListReq`); encode `pkg.Type` so the synthesizer can match it.
+            const joinKey = pkg ? `${pkg}.${requestType}` : requestType;
+            nodes.push({
+                id: `route:${filePath}:${line}:${method}:${routePath}`,
+                kind: 'route',
+                name: `${method} ${routePath}`,
+                // The request type is the synthesizer's join key — encode it after the
+                // marker. The path stays human-readable in `name`.
+                qualifiedName: `${filePath}${exports.GOFRAME_ROUTE_MARKER}${joinKey}`,
+                filePath,
+                startLine: line,
+                endLine: line,
+                startColumn: 0,
+                endColumn: match[0].length,
+                language: 'go',
+                updatedAt: now,
+            });
+        }
+        return { nodes, references: [] };
+    },
+    // The route → controller-method edge is reflective (request-type join across
+    // files) and is built by the `goframeRouteEdges` synthesizer after the graph
+    // is complete. This resolver creates no references of its own.
+    resolve(_ref, _context) {
+        return null;
+    },
+};
+//# sourceMappingURL=goframe.js.map

package/dist/resolution/frameworks/goframe.js.map

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

package/dist/resolution/frameworks/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Framework Resolver Registry
+ *
+ * Manages framework-specific resolvers.
+ */
+import { FrameworkResolver, ResolutionContext } from '../types';
+import type { Language } from '../../types';
+/**
+ * Get all framework resolvers
+ */
+export declare function getAllFrameworkResolvers(): FrameworkResolver[];
+/**
+ * Get a resolver by name
+ */
+export declare function getFrameworkResolver(name: string): FrameworkResolver | undefined;
+/**
+ * Detect which frameworks are used in a project
+ */
+export declare function detectFrameworks(context: ResolutionContext): FrameworkResolver[];
+/**
+ * Filter a list of detected frameworks down to ones that apply to a given language.
+ * Frameworks without an explicit `languages` list are treated as universal.
+ */
+export declare function getApplicableFrameworks(detected: FrameworkResolver[], language: Language): FrameworkResolver[];
+/**
+ * Register a custom framework resolver
+ */
+export declare function registerFrameworkResolver(resolver: FrameworkResolver): void;
+export { springResolver } from './java';
+//# sourceMappingURL=index.d.ts.map

package/dist/resolution/frameworks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resolution/frameworks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAe5C;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,iBAAiB,EAAE,CAE9D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEhF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,EAAE,CAQhF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,QAAQ,EAAE,QAAQ,GACjB,iBAAiB,EAAE,CAIrB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAO3E;AAGD,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC"}

package/dist/resolution/frameworks/index.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * Framework Resolver Registry
+ *
+ * Manages framework-specific resolvers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.springResolver = void 0;
+exports.getAllFrameworkResolvers = getAllFrameworkResolvers;
+exports.getFrameworkResolver = getFrameworkResolver;
+exports.detectFrameworks = detectFrameworks;
+exports.getApplicableFrameworks = getApplicableFrameworks;
+exports.registerFrameworkResolver = registerFrameworkResolver;
+const java_1 = require("./java");
+/**
+ * All registered framework resolvers.
+ *
+ * Java-only build: only the Spring resolver is registered. The other resolver
+ * files still exist in the tree (some are imported by synthesizers) but are
+ * never registered here, so they can never fire on a java-only project.
+ */
+const FRAMEWORK_RESOLVERS = [
+    // Java — Spring Boot (+ config-file key linkage).
+    java_1.springResolver,
+];
+/**
+ * Get all framework resolvers
+ */
+function getAllFrameworkResolvers() {
+    return FRAMEWORK_RESOLVERS;
+}
+/**
+ * Get a resolver by name
+ */
+function getFrameworkResolver(name) {
+    return FRAMEWORK_RESOLVERS.find((r) => r.name === name);
+}
+/**
+ * Detect which frameworks are used in a project
+ */
+function detectFrameworks(context) {
+    return FRAMEWORK_RESOLVERS.filter((resolver) => {
+        try {
+            return resolver.detect(context);
+        }
+        catch {
+            return false;
+        }
+    });
+}
+/**
+ * Filter a list of detected frameworks down to ones that apply to a given language.
+ * Frameworks without an explicit `languages` list are treated as universal.
+ */
+function getApplicableFrameworks(detected, language) {
+    return detected.filter((fw) => !fw.languages || fw.languages.includes(language));
+}
+/**
+ * Register a custom framework resolver
+ */
+function registerFrameworkResolver(resolver) {
+    // Remove existing resolver with same name
+    const index = FRAMEWORK_RESOLVERS.findIndex((r) => r.name === resolver.name);
+    if (index !== -1) {
+        FRAMEWORK_RESOLVERS.splice(index, 1);
+    }
+    FRAMEWORK_RESOLVERS.push(resolver);
+}
+// Re-export framework resolvers
+var java_2 = require("./java");
+Object.defineProperty(exports, "springResolver", { enumerable: true, get: function () { return java_2.springResolver; } });
+//# sourceMappingURL=index.js.map

package/dist/resolution/frameworks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resolution/frameworks/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAqBH,4DAEC;AAKD,oDAEC;AAKD,4CAQC;AAMD,0DAOC;AAKD,8DAOC;AAhED,iCAAwC;AAExC;;;;;;GAMG;AACH,MAAM,mBAAmB,GAAwB;IAC/C,kDAAkD;IAClD,qBAAc;CACf,CAAC;AAEF;;GAEG;AACH,SAAgB,wBAAwB;IACtC,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB,CAAC,IAAY;IAC/C,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,OAA0B;IACzD,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE;QAC7C,IAAI,CAAC;YACH,OAAO,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAgB,uBAAuB,CACrC,QAA6B,EAC7B,QAAkB;IAElB,OAAO,QAAQ,CAAC,MAAM,CACpB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,SAAS,IAAI,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CACzD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,yBAAyB,CAAC,QAA2B;IACnE,0CAA0C;IAC1C,MAAM,KAAK,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7E,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,mBAAmB,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACvC,CAAC;IACD,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED,gCAAgC;AAChC,+BAAwC;AAA/B,sGAAA,cAAc,OAAA"}

package/dist/resolution/frameworks/java.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Java Framework Resolver
+ *
+ * Handles Spring Boot and general Java patterns.
+ */
+import { FrameworkResolver } from '../types';
+export declare const springResolver: FrameworkResolver;
+//# sourceMappingURL=java.d.ts.map

package/dist/resolution/frameworks/java.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"java.d.ts","sourceRoot":"","sources":["../../../src/resolution/frameworks/java.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,iBAAiB,EAAiD,MAAM,UAAU,CAAC;AAG5F,eAAO,MAAM,cAAc,EAAE,iBAsS5B,CAAC"}