@ryanstark24/sfgraph-core 1.1.0 → 1.1.3

package/dist/parsers/apex/__tests__/ast-extractor.test.js

@@ -0,0 +1,146 @@
+import { describe, expect, it } from "vitest";
+import { extractFromAst } from "../ast-extractor.js";
+import { makeTestCtx } from "../../__tests__/_harness.js";
+async function parse(source) {
+    const apex = await import("apex-parser");
+    const { ApexLexer, ApexParser, CommonTokenStream, CaseInsensitiveInputStream, ThrowingErrorListener, } = apex;
+    const input = new CaseInsensitiveInputStream("test.cls", source);
+    const lexer = new ApexLexer(input);
+    lexer.removeErrorListeners();
+    lexer.addErrorListener(new ThrowingErrorListener());
+    const tokens = new CommonTokenStream(lexer);
+    const parser = new ApexParser(tokens);
+    parser.removeErrorListeners();
+    parser.addErrorListener(new ThrowingErrorListener());
+    return parser.compilationUnit();
+}
+function dstSet(edges, rel, all) {
+    const filtered = rel ? (all ?? edges).filter((e) => e.relType === rel) : edges;
+    return filtered.map((e) => String(e.dstQualifiedName)).sort();
+}
+describe("extractFromAst", () => {
+    it("captures SOQL FROM and SELECT-list field reads", async () => {
+        const src = `
+      public class Foo {
+        public void run() {
+          List<Account> accs = [SELECT Id, Name, Phone FROM Account];
+        }
+      }
+    `;
+        const tree = await parse(src);
+        const out = extractFromAst(tree, {
+            ctx: makeTestCtx(),
+            classQname: "ApexClass:Foo",
+            effectiveName: "Foo",
+            namespace: null,
+        });
+        expect(out.edges.some((e) => e.relType === "EXECUTES_SOQL" && e.dstQualifiedName === "CustomObject:Account")).toBe(true);
+        const reads = out.edges.filter((e) => e.relType === "READS_FIELD").map((e) => String(e.dstQualifiedName)).sort();
+        expect(reads).toEqual([
+            "CustomField:Account.Id",
+            "CustomField:Account.Name",
+            "CustomField:Account.Phone",
+        ]);
+    });
+    it("captures dotted field access via local-variable type inference", async () => {
+        const src = `
+      public class Bar {
+        public void run() {
+          Account a = new Account();
+          String n = a.Name;
+        }
+      }
+    `;
+        const tree = await parse(src);
+        const out = extractFromAst(tree, {
+            ctx: makeTestCtx(),
+            classQname: "ApexClass:Bar",
+            effectiveName: "Bar",
+            namespace: null,
+        });
+        expect(out.edges.some((e) => e.relType === "READS_FIELD" && e.dstQualifiedName === "CustomField:Account.Name")).toBe(true);
+        // INSTANCE_OF for new Account()
+        expect(out.edges.some((e) => e.relType === "INSTANCE_OF" && e.dstQualifiedName === "ApexClass:Account")).toBe(true);
+    });
+    it("captures method calls with real arity", async () => {
+        const src = `
+      public class Caller {
+        public void run() {
+          MyService.doIt(1, 'two', null);
+          MyService.doIt();
+        }
+      }
+    `;
+        const tree = await parse(src);
+        const out = extractFromAst(tree, {
+            ctx: makeTestCtx(),
+            classQname: "ApexClass:Caller",
+            effectiveName: "Caller",
+            namespace: null,
+        });
+        const calls = out.edges.filter((e) => e.relType === "CALLS").map((e) => String(e.dstQualifiedName)).sort();
+        expect(calls).toContain("ApexMethod:MyService.doIt(0)");
+        expect(calls).toContain("ApexMethod:MyService.doIt(3)");
+        // None should still have the (?) arity placeholder.
+        for (const c of calls)
+            expect(c).not.toMatch(/\(\?\)$/);
+    });
+    it("infers sObject type for for-each loop variables", async () => {
+        const src = `
+      public class Loop {
+        public void run() {
+          for (Account a : [SELECT Id, Name FROM Account]) {
+            String s = a.Name;
+          }
+        }
+      }
+    `;
+        const tree = await parse(src);
+        const out = extractFromAst(tree, {
+            ctx: makeTestCtx(),
+            classQname: "ApexClass:Loop",
+            effectiveName: "Loop",
+            namespace: null,
+        });
+        // Both SOQL select-list AND dotted access produce Account.Name reads.
+        const accNameReads = out.edges.filter((e) => e.relType === "READS_FIELD" && e.dstQualifiedName === "CustomField:Account.Name");
+        expect(accNameReads.length).toBeGreaterThanOrEqual(1);
+    });
+    it("emits EXECUTES_DML and resolves target sObject when known", async () => {
+        const src = `
+      public class Writer {
+        public void run() {
+          Account a = new Account(Name = 'X');
+          insert a;
+        }
+      }
+    `;
+        const tree = await parse(src);
+        const out = extractFromAst(tree, {
+            ctx: makeTestCtx(),
+            classQname: "ApexClass:Writer",
+            effectiveName: "Writer",
+            namespace: null,
+        });
+        const dml = out.edges.filter((e) => e.relType === "EXECUTES_DML");
+        expect(dml.length).toBe(1);
+        expect(dml[0].attributes.targetSObject).toBe("Account");
+        expect(out.edges.some((e) => e.relType === "WRITES_FIELD" && e.dstQualifiedName === "CustomObject:Account")).toBe(true);
+    });
+    it("captures extends and implements declarations", async () => {
+        const src = `
+      public class Child extends Parent implements MyIface, Other {}
+    `;
+        const tree = await parse(src);
+        const out = extractFromAst(tree, {
+            ctx: makeTestCtx(),
+            classQname: "ApexClass:Child",
+            effectiveName: "Child",
+            namespace: null,
+        });
+        expect(out.edges.some((e) => e.relType === "EXTENDS" && e.dstQualifiedName === "ApexClass:Parent")).toBe(true);
+        const impls = out.edges.filter((e) => e.relType === "IMPLEMENTS").map((e) => String(e.dstQualifiedName)).sort();
+        expect(impls).toEqual(["ApexInterface:MyIface", "ApexInterface:Other"]);
+    });
+});
+//# sourceMappingURL=ast-extractor.test.js.map

package/dist/parsers/apex/__tests__/ast-extractor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-extractor.test.js","sourceRoot":"","sources":["../../../../src/parsers/apex/__tests__/ast-extractor.test.ts"],"names":[],"mappings":"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"}

package/dist/parsers/apex/arity-resolver.d.ts

@@ -0,0 +1,42 @@
+import type { OrgId } from "@ryanstark24/sfgraph-shared";
+import type { GraphStore } from "../../storage/interfaces.js";
+import type { ParseContext } from "../contract.js";
+/**
+ * Rewrites Apex CALLS edges whose `dst` is `ApexMethod:Class.name(?)` —
+ * a placeholder emitted at parse time because the regex-based extractor
+ * can't determine arity from the call site — by matching against real
+ * `ApexMethod` nodes in the graph and emitting edges to every overload.
+ *
+ * Pragmatic semantics:
+ *   - exactly one overload found → edge rewritten to that target, `ambiguous=false`.
+ *   - multiple overloads → one edge per overload, all marked `ambiguous=true`.
+ *   - zero overloads → original edge left in place so the dangling-edge audit
+ *     surfaces it (managed-package targets, typos, third-party imports).
+ *
+ * The new edges carry `resolvedBy:"arity-resolver"` in their attributes so
+ * downstream consumers can distinguish resolver-emitted edges from
+ * extractor-emitted ones.
+ */
+export interface ArityResolveOpts {
+    orgId: OrgId | string;
+    ctx: ParseContext;
+    /** When true, compute the result but do not mutate the graph. */
+    dryRun?: boolean;
+    /** Maximum stranded edges to inspect per call (safety valve for huge orgs).
+     *  Default Number.POSITIVE_INFINITY. */
+    limit?: number;
+}
+export interface ArityResolveResult {
+    /** Stranded edges examined. */
+    scanned: number;
+    /** Stranded edges that found ≥1 target. Counts inputs, not outputs. */
+    resolved: number;
+    /** Stranded edges that found >1 target (subset of `resolved`). */
+    ambiguous: number;
+    /** Stranded edges with no candidate target — left in place. */
+    unresolved: number;
+    /** Total new edges emitted across all rewrites. */
+    edgesEmitted: number;
+}
+export declare function resolveApexMethodArity(store: GraphStore, opts: ArityResolveOpts): ArityResolveResult;
+//# sourceMappingURL=arity-resolver.d.ts.map

package/dist/parsers/apex/arity-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arity-resolver.d.ts","sourceRoot":"","sources":["../../../src/parsers/apex/arity-resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAiB,MAAM,6BAA6B,CAAC;AAExE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC;IACtB,GAAG,EAAE,YAAY,CAAC;IAClB,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;4CACwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;CACtB;AA2BD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,gBAAgB,GACrB,kBAAkB,CAmGpB"}

package/dist/parsers/apex/arity-resolver.js

@@ -0,0 +1,111 @@
+import { asOrgId, asQualifiedName } from "@ryanstark24/sfgraph-shared";
+import { makeEdge } from "../common.js";
+const STRANDED_PATTERN = "ApexMethod:%(?)";
+const QNAME_RE = /^ApexMethod:(.+)\.([A-Za-z_][\w]*)\(\?\)$/;
+const REAL_QNAME_RE = /^ApexMethod:(.+)\.([A-Za-z_][\w]*)\((\d+)\)$/;
+function parseStranded(qname) {
+    const m = QNAME_RE.exec(qname);
+    if (!m)
+        return null;
+    return { className: m[1] ?? "", methodName: m[2] ?? "" };
+}
+function parseResolved(qname) {
+    const m = REAL_QNAME_RE.exec(qname);
+    if (!m)
+        return null;
+    return {
+        className: m[1] ?? "",
+        methodName: m[2] ?? "",
+        arity: Number.parseInt(m[3] ?? "0", 10),
+    };
+}
+export function resolveApexMethodArity(store, opts) {
+    const orgId = typeof opts.orgId === "string" ? asOrgId(opts.orgId) : opts.orgId;
+    // ---- Build the index of real ApexMethod nodes -------------------------
+    const apexMethods = store.listNodesByLabel(orgId, "ApexMethod");
+    const testMethods = store.listNodesByLabel(orgId, "TestMethod");
+    const all = [...apexMethods, ...testMethods];
+    // className -> methodName -> NodeFact[]
+    const index = new Map();
+    for (const n of all) {
+        const parsed = parseResolved(String(n.qualifiedName));
+        if (!parsed)
+            continue;
+        const byMethod = index.get(parsed.className) ?? new Map();
+        const bucket = byMethod.get(parsed.methodName) ?? [];
+        bucket.push(n);
+        byMethod.set(parsed.methodName, bucket);
+        index.set(parsed.className, byMethod);
+    }
+    // ---- Find stranded edges ---------------------------------------------
+    const stranded = store.listEdgesByDstLike(orgId, STRANDED_PATTERN, undefined, opts.limit);
+    const result = {
+        scanned: stranded.length,
+        resolved: 0,
+        ambiguous: 0,
+        unresolved: 0,
+        edgesEmitted: 0,
+    };
+    if (stranded.length === 0)
+        return result;
+    const apply = () => {
+        for (const edge of stranded) {
+            const dst = String(edge.dstQualifiedName);
+            const key = parseStranded(dst);
+            if (!key) {
+                result.unresolved += 1;
+                continue;
+            }
+            const candidates = index.get(key.className)?.get(key.methodName) ?? [];
+            if (candidates.length === 0) {
+                result.unresolved += 1;
+                continue;
+            }
+            result.resolved += 1;
+            if (candidates.length > 1)
+                result.ambiguous += 1;
+            const newEdges = candidates.map((cand) => {
+                const e = makeEdge(opts.ctx, String(edge.srcQualifiedName), edge.relType, String(cand.qualifiedName), {
+                    ...edge.attributes,
+                    unresolvedArity: undefined,
+                    resolvedBy: "arity-resolver",
+                    ambiguous: candidates.length > 1,
+                    overloadCount: candidates.length,
+                });
+                // makeEdge stamps firstSeenAt = now; preserve the original to keep
+                // freshness signals intact. Force orgId to match the stranded
+                // edge in case the caller passed a ParseContext bound to a
+                // different org (defensive — in production they always match).
+                return { ...e, orgId: edge.orgId, firstSeenAt: edge.firstSeenAt };
+            });
+            // Delete the stranded edge, insert real ones in the same transaction.
+            store.deleteEdge(orgId, edge.srcQualifiedName, asQualifiedName(dst), edge.relType);
+            store.mergeEdges(newEdges);
+            result.edgesEmitted += newEdges.length;
+        }
+    };
+    if (opts.dryRun) {
+        // Compute counts without mutating: walk the same logic but skip writes.
+        for (const edge of stranded) {
+            const dst = String(edge.dstQualifiedName);
+            const key = parseStranded(dst);
+            if (!key) {
+                result.unresolved += 1;
+                continue;
+            }
+            const candidates = index.get(key.className)?.get(key.methodName) ?? [];
+            if (candidates.length === 0) {
+                result.unresolved += 1;
+                continue;
+            }
+            result.resolved += 1;
+            if (candidates.length > 1)
+                result.ambiguous += 1;
+            result.edgesEmitted += candidates.length;
+        }
+        return result;
+    }
+    apply();
+    return result;
+}
+//# sourceMappingURL=arity-resolver.js.map

package/dist/parsers/apex/arity-resolver.js.map

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

package/dist/parsers/apex/ast-extractor.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Apex AST-based edge extractor.
+ *
+ * Walks the `apex-parser` ANTLR4 ParseTree to emit edges that the
+ * regex-based extractor in class.ts misses or guesses at:
+ *   - SOQL queries that span multiple lines or contain ternaries / nested
+ *     subqueries; FROM clauses with relationship traversals.
+ *   - DML statements whose target is a variable (regex captured `op` but not
+ *     the real sObject) — resolved here via a per-method symbol table that
+ *     tracks `SObject var` declarations from LocalVariableDeclaration,
+ *     EnhancedForControl (for-each), and FormalParameter.
+ *   - Dotted field access like `a.Name` and relationship traversals
+ *     `Account__r.Name`, resolved against the symbol table.
+ *   - Method calls with **real arity** counted from `expressionList`.
+ *   - `new Foo(args)` creator expressions, again with real arity.
+ *   - Class `extends`/`implements` declarations.
+ *
+ * Edges emitted use the same RelType constants as the regex extractor so
+ * downstream consumers (dead_code_audit, trace_*, freshness_report) keep
+ * working without changes.
+ */
+import type { EdgeFact } from "../../domain/index.js";
+import type { ParseContext } from "../contract.js";
+export interface AstExtractorOpts {
+    ctx: ParseContext;
+    classQname: string;
+    effectiveName: string;
+    namespace: string | null;
+}
+export interface AstExtraction {
+    edges: EdgeFact[];
+    /** Diagnostic messages worth logging in debug mode. Not persisted. */
+    diagnostics: string[];
+    /** Per-method-name → arity, mostly used by tests. */
+    methodArities: Map<string, number>;
+}
+/**
+ * Public entry point. Walks the parsed compilationUnit and returns edges.
+ * Pass the tree returned by `parser.compilationUnit()`.
+ */
+export declare function extractFromAst(tree: unknown, opts: AstExtractorOpts): AstExtraction;
+//# sourceMappingURL=ast-extractor.d.ts.map

package/dist/parsers/apex/ast-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-extractor.d.ts","sourceRoot":"","sources":["../../../src/parsers/apex/ast-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,YAAY,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,sEAAsE;IACtE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,qDAAqD;IACrD,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAybD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,GAAG,aAAa,CAmCnF"}