@ryanstark24/sfgraph-core 1.2.0 → 1.6.0

package/dist/parsers/apex/page-refs.d.ts

@@ -0,0 +1,11 @@
+import { type EdgeFact } from "../../domain/index.js";
+import type { ParseContext } from "../contract.js";
+/**
+ * `Page.<name>` in Apex → REFERENCES `ApexPage:<name>` (`via: "Page"`), so a
+ * Visualforce page reached only from a controller redirect is not dead code.
+ * `code` is comment- and string-stripped. Apex is case-insensitive, so when
+ * the file declares a variable `page` of a type other than PageReference,
+ * `page.x` there is that variable's member and nothing is emitted.
+ */
+export declare function emitPageRefEdges(ctx: ParseContext, srcQname: string, code: string, edges: EdgeFact[]): void;
+//# sourceMappingURL=page-refs.d.ts.map

package/dist/parsers/apex/page-refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-refs.d.ts","sourceRoot":"","sources":["../../../src/parsers/apex/page-refs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAa,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAUnD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,YAAY,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,QAAQ,EAAE,GAChB,IAAI,CAcN"}

package/dist/parsers/apex/page-refs.js

@@ -0,0 +1,34 @@
+import { REL_TYPES } from "../../domain/index.js";
+import { makeEdge, stripNs } from "../common.js";
+// `Page.MyPage`, `Page.MyPage.getUrl()`, `new PageReference(Page.X…)`; not
+// `page.getParameters()` (a PageReference variable's method).
+const PAGE_REF_RE = /(?<![\w.$])page\s*\.\s*([A-Za-z][A-Za-z0-9_]*)\b(?!\s*\()/gi;
+// A variable or parameter named `page`, capturing its declared type.
+const PAGE_DECL_RE = /(?<![\w.$])([A-Za-z_][\w.]*)\s*(?:<[^;=(){}]*>)?\s*(?:\[\s*\])?\s+page\s*[=;,):]/gi;
+const NOT_TYPES = new Set(["return", "new", "else", "throw"]);
+/**
+ * `Page.<name>` in Apex → REFERENCES `ApexPage:<name>` (`via: "Page"`), so a
+ * Visualforce page reached only from a controller redirect is not dead code.
+ * `code` is comment- and string-stripped. Apex is case-insensitive, so when
+ * the file declares a variable `page` of a type other than PageReference,
+ * `page.x` there is that variable's member and nothing is emitted.
+ */
+export function emitPageRefEdges(ctx, srcQname, code, edges) {
+    for (const d of code.matchAll(PAGE_DECL_RE)) {
+        const type = (d[1] ?? "").toLowerCase();
+        if (NOT_TYPES.has(type))
+            continue;
+        if (type !== "pagereference" && type !== "system.pagereference")
+            return;
+    }
+    const seen = new Set();
+    for (const m of code.matchAll(PAGE_REF_RE)) {
+        const dst = `ApexPage:${stripNs(m[1] ?? "", ctx.namespace)}`;
+        const key = dst.toLowerCase();
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        edges.push(makeEdge(ctx, srcQname, REL_TYPES.REFERENCES, dst, { via: "Page" }));
+    }
+}
+//# sourceMappingURL=page-refs.js.map

package/dist/parsers/apex/page-refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-refs.js","sourceRoot":"","sources":["../../../src/parsers/apex/page-refs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGjD,2EAA2E;AAC3E,8DAA8D;AAC9D,MAAM,WAAW,GAAG,6DAA6D,CAAC;AAClF,qEAAqE;AACrE,MAAM,YAAY,GAChB,oFAAoF,CAAC;AACvF,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE9D;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAiB,EACjB,QAAgB,EAChB,IAAY,EACZ,KAAiB;IAEjB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACxC,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAClC,IAAI,IAAI,KAAK,eAAe,IAAI,IAAI,KAAK,sBAAsB;YAAE,OAAO;IAC1E,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC3C,MAAM,GAAG,GAAG,YAAY,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7D,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,CAAC,UAAU,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAClF,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,58 @@
+import type { OrgId } from "@ryanstark24/sfgraph-shared";
+import type { GraphStore } from "../../storage/interfaces.js";
+import type { ParseContext } from "../contract.js";
+/**
+ * Post-merge resolution of two things the Apex parsers can only record,
+ * because they need the rest of the graph:
+ *
+ *  1. `apexRelationshipPaths` (method / class / trigger nodes): relationship
+ *     traversals such as `[SELECT Account.Name FROM Contact]` or
+ *     `acr.Account.Segment__c`. Each hop is resolved through lookup metadata
+ *     (`X__r` → the `X__c` field's `referenceTo`, else the unique field whose
+ *     `relationshipName` is `X`; a standard name → the `<Name>Id` field's
+ *     single `referenceTo`). Without metadata only the platform's standard
+ *     relationship names are used: `Owner` / `CreatedBy` / `LastModifiedBy`
+ *     → User, `Parent` on the hierarchical standard objects → the same
+ *     object, and a name that is itself a standard SObject (`Account`,
+ *     `Product2`). Anything else (polymorphic, unknown) stops the walk and is
+ *     counted, never guessed. Output: READS_FIELD / WRITES_FIELD to the final
+ *     field, REFERENCES to every related object traversed. A final segment
+ *     that is itself a relationship maps to its lookup field when the graph
+ *     knows it, and is otherwise skipped and counted.
+ *  2. `apexChildRelationships`: child-relationship subqueries
+ *     (`(SELECT Status__c FROM Requests__r)` in a query on Account). The child
+ *     object is the one with a lookup to the parent whose source-format
+ *     `relationshipName` (the child relationship name) matches, without
+ *     `__r`; it must be unique. Without metadata a plural of a standard object
+ *     (`Contacts`, `Opportunities`) is that object. Output: REFERENCES to the
+ *     child object (`via: "child-relationship"`) and READS_FIELD to each
+ *     subquery field. Anything else is counted, never guessed.
+ *  3. `apexFieldNameLiterals` (method nodes): a string literal that is exactly a
+ *     custom field name (`setFieldIfNull(acc, 'Tier__c', v)`). READS_FIELD
+ *     `{via: "field-name-literal"}` when exactly one sObject type the method
+ *     declares defines that field; none or several is counted, never guessed.
+ *  4. `testTargetCandidates` (test ApexClass nodes): lowercase-initial names a
+ *     test instantiates or calls; IS_TEST_FOR to the ApexClass whose name
+ *     matches case-insensitively. No naming-convention fallback.
+ *
+ * An edge whose key another producer already emitted (the parser's own
+ * member-access read, say) is left to that producer. Earlier output this run
+ * no longer derives is pruned.
+ */
+export declare const APEX_REF_RESOLVER = "apex-ref-resolver";
+export interface ApexRefResolveResult {
+    pathsResolved: number;
+    pathsUnresolved: number;
+    childRelationshipsResolved: number;
+    childRelationshipsUnresolved: number;
+    testTargetsResolved: number;
+    testTargetsUnresolved: number;
+    fieldLiteralsResolved: number;
+    fieldLiteralsUnresolved: number;
+    /** Parse stat, summed from the nodes: dynamic SOQL clause fields not
+     *  attributed because the query's FROM is computed. */
+    dynamicSoqlFieldsSkipped: number;
+    edgesEmitted: number;
+}
+export declare function resolveApexReferences(store: GraphStore, orgIdIn: OrgId | string, ctx: ParseContext): ApexRefResolveResult;
+//# sourceMappingURL=ref-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ref-resolver.d.ts","sourceRoot":"","sources":["../../../src/parsers/apex/ref-resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAGzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAInD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,0BAA0B,EAAE,MAAM,CAAC;IACnC,4BAA4B,EAAE,MAAM,CAAC;IACrC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uBAAuB,EAAE,MAAM,CAAC;IAChC;2DACuD;IACvD,wBAAwB,EAAE,MAAM,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;CACtB;AAqBD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,KAAK,GAAG,MAAM,EACvB,GAAG,EAAE,YAAY,GAChB,oBAAoB,CA0RtB"}

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

@@ -0,0 +1,348 @@
+import { asOrgId, asQualifiedName } from "@ryanstark24/sfgraph-shared";
+import { REL_TYPES, STANDARD_SOBJECT_WHITELIST } from "../../domain/index.js";
+import { makeEdge } from "../common.js";
+import { pruneStaleResolverEdges } from "../resolver-prune.js";
+/**
+ * Post-merge resolution of two things the Apex parsers can only record,
+ * because they need the rest of the graph:
+ *
+ *  1. `apexRelationshipPaths` (method / class / trigger nodes): relationship
+ *     traversals such as `[SELECT Account.Name FROM Contact]` or
+ *     `acr.Account.Segment__c`. Each hop is resolved through lookup metadata
+ *     (`X__r` → the `X__c` field's `referenceTo`, else the unique field whose
+ *     `relationshipName` is `X`; a standard name → the `<Name>Id` field's
+ *     single `referenceTo`). Without metadata only the platform's standard
+ *     relationship names are used: `Owner` / `CreatedBy` / `LastModifiedBy`
+ *     → User, `Parent` on the hierarchical standard objects → the same
+ *     object, and a name that is itself a standard SObject (`Account`,
+ *     `Product2`). Anything else (polymorphic, unknown) stops the walk and is
+ *     counted, never guessed. Output: READS_FIELD / WRITES_FIELD to the final
+ *     field, REFERENCES to every related object traversed. A final segment
+ *     that is itself a relationship maps to its lookup field when the graph
+ *     knows it, and is otherwise skipped and counted.
+ *  2. `apexChildRelationships`: child-relationship subqueries
+ *     (`(SELECT Status__c FROM Requests__r)` in a query on Account). The child
+ *     object is the one with a lookup to the parent whose source-format
+ *     `relationshipName` (the child relationship name) matches, without
+ *     `__r`; it must be unique. Without metadata a plural of a standard object
+ *     (`Contacts`, `Opportunities`) is that object. Output: REFERENCES to the
+ *     child object (`via: "child-relationship"`) and READS_FIELD to each
+ *     subquery field. Anything else is counted, never guessed.
+ *  3. `apexFieldNameLiterals` (method nodes): a string literal that is exactly a
+ *     custom field name (`setFieldIfNull(acc, 'Tier__c', v)`). READS_FIELD
+ *     `{via: "field-name-literal"}` when exactly one sObject type the method
+ *     declares defines that field; none or several is counted, never guessed.
+ *  4. `testTargetCandidates` (test ApexClass nodes): lowercase-initial names a
+ *     test instantiates or calls; IS_TEST_FOR to the ApexClass whose name
+ *     matches case-insensitively. No naming-convention fallback.
+ *
+ * An edge whose key another producer already emitted (the parser's own
+ * member-access read, say) is left to that producer. Earlier output this run
+ * no longer derives is pruned.
+ */
+export const APEX_REF_RESOLVER = "apex-ref-resolver";
+const PATH_LABELS = ["ApexMethod", "TestMethod", "ApexClass", "ApexTrigger"];
+/** Field metadata types that are relationships (a `<Seg>Id` leaf of one is a read of it). */
+const LOOKUP_TYPES = new Set([
+    "Lookup",
+    "MasterDetail",
+    "Hierarchy",
+    "ExternalLookup",
+    "IndirectLookup",
+    "MetadataRelationship",
+]);
+const USER_RELS = new Set(["owner", "createdby", "lastmodifiedby"]);
+/** Standard objects whose `Parent` relationship is a self-lookup. */
+const SELF_PARENT = new Set(["account", "asset", "campaign", "case"]);
+const STANDARD_BY_LOWER = new Map([...STANDARD_SOBJECT_WHITELIST].map((n) => [n.toLowerCase(), n]));
+const keyOf = (rel, src, dst) => `${rel}|${src}|${dst}`.toLowerCase();
+export function resolveApexReferences(store, orgIdIn, ctx) {
+    const orgId = typeof orgIdIn === "string" ? asOrgId(orgIdIn) : orgIdIn;
+    const result = {
+        pathsResolved: 0,
+        pathsUnresolved: 0,
+        childRelationshipsResolved: 0,
+        childRelationshipsUnresolved: 0,
+        testTargetsResolved: 0,
+        testTargetsUnresolved: 0,
+        fieldLiteralsResolved: 0,
+        fieldLiteralsUnresolved: 0,
+        dynamicSoqlFieldsSkipped: 0,
+        edgesEmitted: 0,
+    };
+    const previous = [
+        ...store.listEdgesByDstLike(orgId, "CustomField:%", REL_TYPES.READS_FIELD),
+        ...store.listEdgesByDstLike(orgId, "CustomField:%", REL_TYPES.WRITES_FIELD),
+        ...store.listEdgesByDstLike(orgId, "CustomObject:%", REL_TYPES.REFERENCES),
+        ...store.listEdgesByDstLike(orgId, "ApexClass:%", REL_TYPES.IS_TEST_FOR),
+    ];
+    // Keys another producer owns (parser edges): never overwritten.
+    const foreign = new Set();
+    for (const e of previous) {
+        const a = (e.attributes ?? {});
+        if (a.resolvedBy === APEX_REF_RESOLVER || a.source === "reflection")
+            continue;
+        foreign.add(keyOf(e.relType, String(e.srcQualifiedName), String(e.dstQualifiedName)));
+    }
+    // Per-object field index (lower-cased API name and relationship name).
+    const fieldIndex = new Map();
+    const fieldsOf = (obj) => {
+        const key = obj.toLowerCase();
+        let idx = fieldIndex.get(key);
+        if (idx)
+            return idx;
+        idx = { byName: new Map(), byRel: new Map() };
+        for (const e of store.listEdgesFrom(orgId, asQualifiedName(`CustomObject:${obj}`), REL_TYPES.DEFINES_FIELD)) {
+            const n = store.getNode(orgId, e.dstQualifiedName);
+            if (!n)
+                continue;
+            const qn = String(n.qualifiedName);
+            idx.byName.set(qn.slice(qn.indexOf(".") + 1).toLowerCase(), n);
+            const rn = n.attributes.relationshipName;
+            if (typeof rn === "string" && rn) {
+                const b = idx.byRel.get(rn.toLowerCase()) ?? [];
+                b.push(n);
+                idx.byRel.set(rn.toLowerCase(), b);
+            }
+        }
+        fieldIndex.set(key, idx);
+        return idx;
+    };
+    const fieldNode = (obj, field) => store.getNode(orgId, asQualifiedName(`CustomField:${obj}.${field}`)) ??
+        fieldsOf(obj).byName.get(field.toLowerCase()) ??
+        null;
+    const targetsOf = (n) => {
+        const ref = n ? n.attributes.referenceTo : undefined;
+        return Array.isArray(ref) ? ref.map(String).filter(Boolean) : [];
+    };
+    const isLookupField = (n) => {
+        const t = n.attributes.type;
+        return targetsOf(n).length > 0 || (typeof t === "string" && LOOKUP_TYPES.has(t));
+    };
+    /** The single object relationship `seg` on `obj` leads to, or null. */
+    const hop = (obj, seg) => {
+        const lower = seg.toLowerCase();
+        if (lower.endsWith("__r")) {
+            const base = seg.slice(0, -3);
+            const named = fieldNode(obj, `${base}__c`);
+            if (named && targetsOf(named).length > 0) {
+                const t = targetsOf(named);
+                return t.length === 1 ? (t[0] ?? null) : null;
+            }
+            const byRel = fieldsOf(obj).byRel.get(base.toLowerCase()) ?? [];
+            if (byRel.length !== 1)
+                return null;
+            const t = targetsOf(byRel[0] ?? null);
+            return t.length === 1 ? (t[0] ?? null) : null;
+        }
+        const idField = fieldNode(obj, `${seg}Id`);
+        const t = targetsOf(idField);
+        if (t.length === 1)
+            return t[0] ?? null;
+        if (t.length > 1 && !USER_RELS.has(lower))
+            return null; // polymorphic
+        if (USER_RELS.has(lower))
+            return "User";
+        if (lower === "parent")
+            return SELF_PARENT.has(obj.toLowerCase()) ? obj : null;
+        return STANDARD_BY_LOWER.get(lower) ?? null;
+    };
+    /**
+     * When the last segment is itself a relationship (`X__r`, or a standard one such as
+     * `RecordType` / `Owner` with no field of that name), the read is of its lookup field:
+     * `X__c` (or the unique field whose relationshipName is X) / `<seg>Id`, if the graph knows it.
+     * Returns that field, `null` when it is a relationship whose lookup field is unknown (skip),
+     * or `undefined` when the segment is a plain field.
+     */
+    const leafField = (obj, seg) => {
+        const lower = seg.toLowerCase();
+        if (lower.endsWith("__r")) {
+            const base = seg.slice(0, -3);
+            const named = fieldNode(obj, `${base}__c`);
+            if (named)
+                return named;
+            const byRel = fieldsOf(obj).byRel.get(base.toLowerCase()) ?? [];
+            return byRel.length === 1 ? (byRel[0] ?? null) : null;
+        }
+        if (fieldNode(obj, seg))
+            return undefined;
+        // `<seg>Id` is the relationship's lookup only when it is one (T15): it has a
+        // referenceTo, or its metadata type is a lookup / master-detail (standard
+        // field metadata often omits referenceTo). A plain `FooId` is not `Foo`.
+        const idField = fieldNode(obj, `${seg}Id`);
+        if (idField && isLookupField(idField))
+            return idField;
+        if (USER_RELS.has(lower) || lower === "parent" || STANDARD_BY_LOWER.has(lower))
+            return null;
+        return undefined;
+    };
+    const newEdges = [];
+    const emitted = new Set();
+    const push = (src, rel, dst, attrs) => {
+        const s = String(src.qualifiedName);
+        const k = keyOf(rel, s, dst);
+        if (foreign.has(k) || emitted.has(k))
+            return;
+        emitted.add(k);
+        newEdges.push({
+            ...makeEdge(ctx, s, rel, dst, { resolvedBy: APEX_REF_RESOLVER, ...attrs }),
+            orgId,
+            firstSeenAt: src.firstSeenAt,
+        });
+    };
+    for (const label of PATH_LABELS) {
+        for (const n of store.listNodesByLabel(orgId, label)) {
+            const skipped = n.attributes.dynamicSoqlFieldsSkipped;
+            if (typeof skipped === "number" && skipped > 0)
+                result.dynamicSoqlFieldsSkipped += skipped;
+            const paths = n.attributes.apexRelationshipPaths;
+            if (!Array.isArray(paths))
+                continue;
+            for (const p of paths) {
+                if (!p || typeof p.object !== "string" || typeof p.path !== "string")
+                    continue;
+                const rel = p.rel === REL_TYPES.WRITES_FIELD ? REL_TYPES.WRITES_FIELD : REL_TYPES.READS_FIELD;
+                const segs = p.path.split(".");
+                const last = segs.pop() ?? "";
+                let cur = p.object;
+                const via = [];
+                for (const seg of segs) {
+                    cur = hop(cur, seg);
+                    if (!cur)
+                        break;
+                    via.push(cur);
+                }
+                if (!cur || !last) {
+                    result.pathsUnresolved += 1;
+                    continue;
+                }
+                const leaf = leafField(cur, last);
+                if (leaf === null) {
+                    result.pathsUnresolved += 1;
+                    continue;
+                }
+                result.pathsResolved += 1;
+                const fin = leaf ?? fieldNode(cur, last);
+                push(n, rel, fin ? String(fin.qualifiedName) : `CustomField:${cur}.${last}`, {
+                    path: p.path,
+                });
+                for (const o of via)
+                    push(n, REL_TYPES.REFERENCES, `CustomObject:${o}`, {
+                        via: "relationship-path",
+                        path: p.path,
+                    });
+            }
+        }
+    }
+    // Child-relationship subqueries → the child object. Lookups by parent,
+    // built on first use: lower-cased parent → child relationship name → children.
+    let childIndex = null;
+    const childOf = (parent, relationship) => {
+        if (!childIndex) {
+            childIndex = new Map();
+            for (const f of store.listNodesByLabel(orgId, "CustomField")) {
+                const rn = f.attributes.relationshipName;
+                if (typeof rn !== "string" || !rn)
+                    continue;
+                const qn = String(f.qualifiedName);
+                const child = qn.slice(qn.indexOf(":") + 1, qn.indexOf("."));
+                for (const t of targetsOf(f)) {
+                    const byName = childIndex.get(t.toLowerCase()) ?? new Map();
+                    const key = rn.toLowerCase().replace(/__r$/, "");
+                    const set = byName.get(key) ?? new Set();
+                    set.add(child);
+                    byName.set(key, set);
+                    childIndex.set(t.toLowerCase(), byName);
+                }
+            }
+        }
+        const lower = relationship.toLowerCase();
+        const hits = childIndex.get(parent.toLowerCase())?.get(lower.replace(/__r$/, ""));
+        if (hits)
+            return hits.size === 1 ? ([...hits][0] ?? null) : null;
+        if (lower.endsWith("__r"))
+            return null;
+        const single = lower.endsWith("ies") ? `${lower.slice(0, -3)}y` : lower.replace(/s$/, "");
+        return single !== lower ? (STANDARD_BY_LOWER.get(single) ?? null) : null;
+    };
+    for (const label of PATH_LABELS) {
+        for (const n of store.listNodesByLabel(orgId, label)) {
+            const rels = n.attributes.apexChildRelationships;
+            if (!Array.isArray(rels))
+                continue;
+            for (const r of rels) {
+                if (!r || typeof r.object !== "string" || typeof r.relationship !== "string")
+                    continue;
+                const child = childOf(r.object, r.relationship);
+                if (!child) {
+                    result.childRelationshipsUnresolved += 1;
+                    continue;
+                }
+                result.childRelationshipsResolved += 1;
+                const attrs = { via: "child-relationship", relationship: r.relationship };
+                push(n, REL_TYPES.REFERENCES, `CustomObject:${child}`, attrs);
+                for (const f of Array.isArray(r.fields) ? r.fields : []) {
+                    if (typeof f !== "string" || !f)
+                        continue;
+                    const fin = fieldNode(child, f);
+                    push(n, REL_TYPES.READS_FIELD, fin ? String(fin.qualifiedName) : `CustomField:${child}.${f}`, attrs);
+                }
+            }
+        }
+    }
+    // Field names passed as text → the one declared sObject that defines the field.
+    for (const label of ["ApexMethod", "TestMethod"]) {
+        for (const n of store.listNodesByLabel(orgId, label)) {
+            const lits = n.attributes.apexFieldNameLiterals;
+            if (!Array.isArray(lits))
+                continue;
+            for (const l of lits) {
+                if (!l || typeof l.field !== "string" || !Array.isArray(l.objects))
+                    continue;
+                const hits = new Map();
+                for (const o of l.objects) {
+                    if (typeof o !== "string")
+                        continue;
+                    const f = fieldNode(o, l.field);
+                    if (f)
+                        hits.set(String(f.qualifiedName).toLowerCase(), f);
+                }
+                const only = hits.size === 1 ? [...hits.values()][0] : undefined;
+                if (!only) {
+                    result.fieldLiteralsUnresolved += 1;
+                    continue;
+                }
+                result.fieldLiteralsResolved += 1;
+                push(n, REL_TYPES.READS_FIELD, String(only.qualifiedName), { via: "field-name-literal" });
+            }
+        }
+    }
+    // Lowercase-initial test targets → existing ApexClass nodes.
+    const classes = store.listNodesByLabel(orgId, "ApexClass");
+    const byLower = new Map();
+    for (const c of classes)
+        byLower.set(String(c.qualifiedName).toLowerCase(), String(c.qualifiedName));
+    for (const c of classes) {
+        const cands = c.attributes.testTargetCandidates;
+        if (!Array.isArray(cands))
+            continue;
+        const self = String(c.qualifiedName).toLowerCase();
+        for (const raw of cands) {
+            if (typeof raw !== "string" || !raw)
+                continue;
+            const hit = byLower.get(`apexclass:${raw.toLowerCase()}`);
+            if (!hit || hit.toLowerCase() === self) {
+                result.testTargetsUnresolved += 1;
+                continue;
+            }
+            result.testTargetsResolved += 1;
+            push(c, REL_TYPES.IS_TEST_FOR, hit, {});
+        }
+    }
+    pruneStaleResolverEdges(store, orgId, APEX_REF_RESOLVER, previous, newEdges);
+    if (newEdges.length > 0)
+        store.mergeEdges(newEdges);
+    result.edgesEmitted = newEdges.length;
+    return result;
+}
+//# sourceMappingURL=ref-resolver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ref-resolver.js","sourceRoot":"","sources":["../../../src/parsers/apex/ref-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAGvE,OAAO,EAAE,SAAS,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAE9E,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAG/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AAiBrD,MAAM,WAAW,GAAG,CAAC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,CAAU,CAAC;AACtF,6FAA6F;AAC7F,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAC3B,QAAQ;IACR,cAAc;IACd,WAAW;IACX,gBAAgB;IAChB,gBAAgB;IAChB,sBAAsB;CACvB,CAAC,CAAC;AACH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,gBAAgB,CAAC,CAAC,CAAC;AACpE,qEAAqE;AACrE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AACtE,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAC/B,CAAC,GAAG,0BAA0B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAU,CAAC,CAC1E,CAAC;AAEF,MAAM,KAAK,GAAG,CAAC,GAAW,EAAE,GAAW,EAAE,GAAW,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;AAE9F,MAAM,UAAU,qBAAqB,CACnC,KAAiB,EACjB,OAAuB,EACvB,GAAiB;IAEjB,MAAM,KAAK,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACvE,MAAM,MAAM,GAAyB;QACnC,aAAa,EAAE,CAAC;QAChB,eAAe,EAAE,CAAC;QAClB,0BAA0B,EAAE,CAAC;QAC7B,4BAA4B,EAAE,CAAC;QAC/B,mBAAmB,EAAE,CAAC;QACtB,qBAAqB,EAAE,CAAC;QACxB,qBAAqB,EAAE,CAAC;QACxB,uBAAuB,EAAE,CAAC;QAC1B,wBAAwB,EAAE,CAAC;QAC3B,YAAY,EAAE,CAAC;KAChB,CAAC;IAEF,MAAM,QAAQ,GAAe;QAC3B,GAAG,KAAK,CAAC,kBAAkB,CAAC,KAAK,EAAE,eAAe,EAAE,SAAS,CAAC,WAAW,CAAC;QAC1E,GAAG,KAAK,CAAC,kBAAkB,CAAC,KAAK,EAAE,eAAe,EAAE,SAAS,CAAC,YAAY,CAAC;QAC3E,GAAG,KAAK,CAAC,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,EAAE,SAAS,CAAC,UAAU,CAAC;QAC1E,GAAG,KAAK,CAAC,kBAAkB,CAAC,KAAK,EAAE,aAAa,EAAE,SAAS,CAAC,WAAW,CAAC;KACzE,CAAC;IACF,gEAAgE;IAChE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAA4B,CAAC;QAC1D,IAAI,CAAC,CAAC,UAAU,KAAK,iBAAiB,IAAI,CAAC,CAAC,MAAM,KAAK,YAAY;YAAE,SAAS;QAC9E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACxF,CAAC;IAED,uEAAuE;IACvE,MAAM,UAAU,GAAG,IAAI,GAAG,EAGvB,CAAC;IACJ,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAE,EAAE;QAC/B,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QAC9B,IAAI,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;QACpB,GAAG,GAAG,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;QAC9C,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,aAAa,CACjC,KAAK,EACL,eAAe,CAAC,gBAAgB,GAAG,EAAE,CAAC,EACtC,SAAS,CAAC,aAAa,CACxB,EAAE,CAAC;YACF,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,gBAAgB,CAAC,CAAC;YACnD,IAAI,CAAC,CAAC;gBAAE,SAAS;YACjB,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;YACnC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;YAC/D,MAAM,EAAE,GAAI,CAAC,CAAC,UAAsC,CAAC,gBAAgB,CAAC;YACtE,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,EAAE,CAAC;gBACjC,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;gBAChD,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACV,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QACD,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACzB,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IACF,MAAM,SAAS,GAAG,CAAC,GAAW,EAAE,KAAa,EAAmB,EAAE,CAChE,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,eAAe,CAAC,eAAe,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC;QACpE,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QAC7C,IAAI,CAAC;IACP,MAAM,SAAS,GAAG,CAAC,CAAkB,EAAY,EAAE;QACjD,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,UAAsC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;QAClF,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,CAAC,CAAC;IACF,MAAM,aAAa,GAAG,CAAC,CAAW,EAAW,EAAE;QAC7C,MAAM,CAAC,GAAI,CAAC,CAAC,UAAsC,CAAC,IAAI,CAAC;QACzD,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,CAAC,CAAC;IAEF,uEAAuE;IACvE,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,GAAW,EAAiB,EAAE;QACtD,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QAChC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC9B,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;YAC3C,IAAI,KAAK,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzC,MAAM,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;gBAC3B,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAChD,CAAC;YACD,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;YAChE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YACpC,MAAM,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;YACtC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAChD,CAAC;QACD,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC,CAAC;QAC3C,MAAM,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QAC7B,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QACxC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,CAAC,cAAc;QACtE,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC;QACxC,IAAI,KAAK,KAAK,QAAQ;YAAE,OAAO,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/E,OAAO,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;IAC9C,CAAC,CAAC;IAEF;;;;;;OAMG;IACH,MAAM,SAAS,GAAG,CAAC,GAAW,EAAE,GAAW,EAA+B,EAAE;QAC1E,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QAChC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC9B,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;YAC3C,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAC;YACxB,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;YAChE,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACxD,CAAC;QACD,IAAI,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QAC1C,6EAA6E;QAC7E,0EAA0E;QAC1E,yEAAyE;QACzE,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC,CAAC;QAC3C,IAAI,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC;YAAE,OAAO,OAAO,CAAC;QACtD,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,QAAQ,IAAI,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC5F,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAe,EAAE,CAAC;IAChC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,IAAI,GAAG,CAAC,GAAa,EAAE,GAAY,EAAE,GAAW,EAAE,KAA8B,EAAE,EAAE;QACxF,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACpC,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QAC7B,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,OAAO;QAC7C,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACf,QAAQ,CAAC,IAAI,CAAC;YACZ,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,iBAAiB,EAAE,GAAG,KAAK,EAAE,CAAC;YAC1E,KAAK;YACL,WAAW,EAAE,GAAG,CAAC,WAAW;SAC7B,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;YACrD,MAAM,OAAO,GAAI,CAAC,CAAC,UAAsC,CAAC,wBAAwB,CAAC;YACnF,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC;gBAAE,MAAM,CAAC,wBAAwB,IAAI,OAAO,CAAC;YAC3F,MAAM,KAAK,GAAI,CAAC,CAAC,UAAsC,CAAC,qBAAqB,CAAC;YAC9E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,SAAS;YACpC,KAAK,MAAM,CAAC,IAAI,KAA+B,EAAE,CAAC;gBAChD,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;oBAAE,SAAS;gBAC/E,MAAM,GAAG,GACP,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC;gBACpF,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;gBAC9B,IAAI,GAAG,GAAkB,CAAC,CAAC,MAAM,CAAC;gBAClC,MAAM,GAAG,GAAa,EAAE,CAAC;gBACzB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;oBACvB,GAAG,GAAG,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;oBACpB,IAAI,CAAC,GAAG;wBAAE,MAAM;oBAChB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAChB,CAAC;gBACD,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;oBAClB,MAAM,CAAC,eAAe,IAAI,CAAC,CAAC;oBAC5B,SAAS;gBACX,CAAC;gBACD,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBAClC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;oBAClB,MAAM,CAAC,eAAe,IAAI,CAAC,CAAC;oBAC5B,SAAS;gBACX,CAAC;gBACD,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC;gBAC1B,MAAM,GAAG,GAAG,IAAI,IAAI,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBACzC,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,eAAe,GAAG,IAAI,IAAI,EAAE,EAAE;oBAC3E,IAAI,EAAE,CAAC,CAAC,IAAI;iBACb,CAAC,CAAC;gBACH,KAAK,MAAM,CAAC,IAAI,GAAG;oBACjB,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC,UAAU,EAAE,gBAAgB,CAAC,EAAE,EAAE;wBACjD,GAAG,EAAE,mBAAmB;wBACxB,IAAI,EAAE,CAAC,CAAC,IAAI;qBACb,CAAC,CAAC;YACP,CAAC;QACH,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,+EAA+E;IAC/E,IAAI,UAAU,GAAiD,IAAI,CAAC;IACpE,MAAM,OAAO,GAAG,CAAC,MAAc,EAAE,YAAoB,EAAiB,EAAE;QACtE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,UAAU,GAAG,IAAI,GAAG,EAAE,CAAC;YACvB,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,KAAK,EAAE,aAAa,CAAC,EAAE,CAAC;gBAC7D,MAAM,EAAE,GAAI,CAAC,CAAC,UAAsC,CAAC,gBAAgB,CAAC;gBACtE,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,EAAE;oBAAE,SAAS;gBAC5C,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;gBACnC,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC7D,KAAK,MAAM,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC7B,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,IAAI,GAAG,EAAuB,CAAC;oBACjF,MAAM,GAAG,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;oBACjD,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC;oBACjD,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;oBACf,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;oBACrB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC;gBAC1C,CAAC;YACH,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;QAClF,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACjE,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACvC,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1F,OAAO,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3E,CAAC,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,GAAI,CAAC,CAAC,UAAsC,CAAC,sBAAsB,CAAC;YAC9E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;gBAAE,SAAS;YACnC,KAAK,MAAM,CAAC,IAAI,IAA+B,EAAE,CAAC;gBAChD,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ;oBAAE,SAAS;gBACvF,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC;gBAChD,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,MAAM,CAAC,4BAA4B,IAAI,CAAC,CAAC;oBACzC,SAAS;gBACX,CAAC;gBACD,MAAM,CAAC,0BAA0B,IAAI,CAAC,CAAC;gBACvC,MAAM,KAAK,GAAG,EAAE,GAAG,EAAE,oBAAoB,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC;gBAC1E,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC,UAAU,EAAE,gBAAgB,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;gBAC9D,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;oBACxD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC;wBAAE,SAAS;oBAC1C,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;oBAChC,IAAI,CACF,CAAC,EACD,SAAS,CAAC,WAAW,EACrB,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,eAAe,KAAK,IAAI,CAAC,EAAE,EAC7D,KAAK,CACN,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,gFAAgF;IAChF,KAAK,MAAM,KAAK,IAAI,CAAC,YAAY,EAAE,YAAY,CAAU,EAAE,CAAC;QAC1D,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,GAAI,CAAC,CAAC,UAAsC,CAAC,qBAAqB,CAAC;YAC7E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;gBAAE,SAAS;YACnC,KAAK,MAAM,CAAC,IAAI,IAA8B,EAAE,CAAC;gBAC/C,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;oBAAE,SAAS;gBAC7E,MAAM,IAAI,GAAG,IAAI,GAAG,EAAoB,CAAC;gBACzC,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;oBAC1B,IAAI,OAAO,CAAC,KAAK,QAAQ;wBAAE,SAAS;oBACpC,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;oBAChC,IAAI,CAAC;wBAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;gBAC5D,CAAC;gBACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBACjE,IAAI,CAAC,IAAI,EAAE,CAAC;oBACV,MAAM,CAAC,uBAAuB,IAAI,CAAC,CAAC;oBACpC,SAAS;gBACX,CAAC;gBACD,MAAM,CAAC,qBAAqB,IAAI,CAAC,CAAC;gBAClC,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,GAAG,EAAE,oBAAoB,EAAE,CAAC,CAAC;YAC5F,CAAC;QACH,CAAC;IACH,CAAC;IAED,6DAA6D;IAC7D,MAAM,OAAO,GAAG,KAAK,CAAC,gBAAgB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,KAAK,MAAM,CAAC,IAAI,OAAO;QACrB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;IAC9E,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,KAAK,GAAI,CAAC,CAAC,UAAsC,CAAC,oBAAoB,CAAC;QAC7E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,SAAS;QACpC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;QACnD,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;YACxB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG;gBAAE,SAAS;YAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAC1D,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC;gBACvC,MAAM,CAAC,qBAAqB,IAAI,CAAC,CAAC;gBAClC,SAAS;YACX,CAAC;YACD,MAAM,CAAC,mBAAmB,IAAI,CAAC,CAAC;YAChC,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC,WAAW,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,uBAAuB,CAAC,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC7E,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACpD,MAAM,CAAC,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC;IACtC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/parsers/apex/soql-fields.d.ts

@@ -0,0 +1,75 @@
+/**
+ * SOQL grammar helpers for the regex Apex path: the field references of one
+ * inline query, taken from the outer query only (parenthesised subqueries
+ * and semi-joins are blanked first).
+ *
+ *   - SELECT list: plain identifiers and dotted paths (an alias after a
+ *     field is ignored; aggregate / function items and `*` are skipped).
+ *   - WHERE / HAVING: the field operand of each comparison
+ *     (`F = …`, `F != …`, `F <> …`, `F < …`, `F LIKE …`, `F IN …`,
+ *     `F NOT IN …`, `F INCLUDES …`, `F EXCLUDES …`), also wrapped in a date
+ *     function (`CALENDAR_YEAR(F) = 2020`). Bind expressions (`:x.y`) and
+ *     literal values are never fields.
+ *   - GROUP BY (incl. ROLLUP / CUBE) and ORDER BY lists.
+ *
+ * A SELECT-list `TYPEOF Rel WHEN T THEN f1, f2 … [ELSE …] END` reads the
+ * polymorphic lookup field (`What` -> `WhatId`, `Foo__r` -> `Foo__c`) of the
+ * FROM object and each branch's fields on that branch's type (`typeOf`); the
+ * ELSE branch's object is unknown and is skipped.
+ *
+ * A leading FROM alias (`FROM Contact c` … `c.Name`) is stripped. Single
+ * names are `fields` of the FROM object; dotted names are relationship
+ * `paths` (`Account.Name`), resolved later through lookup metadata.
+ */
+export interface SoqlFieldRefs {
+    /** Outer FROM object as written (namespace not stripped), or null. */
+    object: string | null;
+    /** Plain field names of the FROM object, first-seen order, deduped (case-insensitive). */
+    fields: string[];
+    /** Dotted relationship paths (`Account.Name`), first-seen order, deduped. */
+    paths: string[];
+    /** The plain field operands of WHERE / HAVING / GROUP BY / ORDER BY only
+     *  (a subset of `fields` plus any also in the SELECT list), deduped. */
+    clauseFields: string[];
+    /** Fields read per WHEN type of SELECT-list `TYPEOF` blocks, one entry per type. */
+    typeOf: SoqlTypeOfBranch[];
+}
+/** One `WHEN <object> THEN …` type of a `TYPEOF` block. */
+export interface SoqlTypeOfBranch {
+    object: string;
+    fields: string[];
+    paths: string[];
+}
+/**
+ * Field references of a query's inner text (everything after `[SELECT`, up
+ * to but excluding the closing `]`).
+ */
+export declare function soqlFieldRefs(inner: string): SoqlFieldRefs;
+/** One inline query found by findInlineQueries. */
+export interface InlineQuery {
+    /** Offset of the opening `[`. */
+    index: number;
+    /** Full text from `[` to the matching `]`, inclusive. */
+    text: string;
+    /** Text after the start keyword, up to but excluding the closing `]`. */
+    inner: string;
+}
+/**
+ * Inline `[SELECT …]` queries (or `[FIND …]` with `keyword = "FIND"`) in
+ * Apex code, in start order. A query ends at the `]` that brings bracket
+ * depth back to 0, counted outside `'…'` string literals (`\'` escapes), so
+ * a bind expression that indexes (`:ids[0]`, `:m.get(k)[1]`) or holds
+ * another inline query does not end it early. An inline query nested in a
+ * bind is returned too, after its outer query. A query whose closing
+ * bracket (or a string inside it) never closes is not returned.
+ *
+ * Precondition: `code` has its comments masked or removed (`maskApex` or
+ * `stripCommentsAndStrings`). The scanner does not recognise `//` or
+ * `/* *\/` comments: on raw text a quote inside a comment (`// don't`)
+ * opens a literal that swallows the queries after it, and a `]` inside a
+ * comment within a query ends that query early.
+ */
+export declare function findInlineQueries(code: string, keyword?: string): InlineQuery[];
+/** Blank (length-preserving) the contents of every `[…]` group in `s`, brackets kept. */
+export declare function blankBracketGroups(s: string): string;
+//# sourceMappingURL=soql-fields.d.ts.map

package/dist/parsers/apex/soql-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"soql-fields.d.ts","sourceRoot":"","sources":["../../../src/parsers/apex/soql-fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AA0BH,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,0FAA0F;IAC1F,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,6EAA6E;IAC7E,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;4EACwE;IACxE,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,oFAAoF;IACpF,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,2DAA2D;AAC3D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAgFD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAkG1D;AAED,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;CACf;AAWD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,SAAW,GAAG,WAAW,EAAE,CAsCjF;AAED,yFAAyF;AACzF,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAmBpD"}