@ryanstark24/sfgraph-core 1.1.0

package/dist/analyze/__tests__/wip-impact.test.js

@@ -0,0 +1,134 @@
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { asOrgId, asQualifiedName, asSha256 } from "@ryanstark24/sfgraph-shared";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { REL_TYPES } from "../../domain/index.js";
+import { SqliteGraphStore } from "../../storage/index.js";
+import { analyzeLocalImpact } from "../wip-impact.js";
+let workDir;
+let dbPath;
+let projectRoot;
+let store;
+const orgId = asOrgId("orgWip");
+function seedNode(qname, label, sourceHash = "seeded-hash") {
+    return {
+        orgId,
+        qualifiedName: asQualifiedName(qname),
+        label,
+        attributes: {},
+        sourceHash: asSha256(sourceHash),
+        firstSeenAt: 1,
+        lastSeenAt: 1,
+        lastModifiedAt: 1,
+    };
+}
+function seedEdge(src, dst, relType) {
+    return {
+        orgId,
+        srcQualifiedName: asQualifiedName(src),
+        dstQualifiedName: asQualifiedName(dst),
+        relType: relType,
+        attributes: {},
+        firstSeenAt: 1,
+        lastSeenAt: 1,
+    };
+}
+function w(rel, content) {
+    const abs = path.join(projectRoot, rel);
+    mkdirSync(path.dirname(abs), { recursive: true });
+    writeFileSync(abs, content, "utf8");
+}
+beforeEach(async () => {
+    workDir = mkdtempSync(path.join(tmpdir(), "sfg-wip-"));
+    dbPath = path.join(workDir, "g.sqlite");
+    projectRoot = path.join(workDir, "proj");
+    mkdirSync(projectRoot, { recursive: true });
+    store = new SqliteGraphStore({ dbPath });
+    await store.init();
+    store.upsertOrg({
+        id: orgId,
+        alias: "wip-test",
+        instanceUrl: "https://example",
+        apiVersion: "60.0",
+        createdAt: 1,
+    });
+});
+afterEach(async () => {
+    await store.close();
+    rmSync(workDir, { recursive: true, force: true });
+});
+describe("analyzeLocalImpact", () => {
+    it("detects changed (modified) ApexClass file", async () => {
+        // Seed persisted ApexClass:Foo with placeholder hash.
+        store.mergeNodes([seedNode("ApexClass:Foo", "ApexClass")]);
+        // Write a local source file (will hash differently from seed).
+        w("force-app/main/default/classes/Foo.cls", "public class Foo { void m(){} }");
+        const result = await analyzeLocalImpact({
+            graphStore: store,
+            orgId,
+            projectRoot,
+        });
+        expect(result.changedQnames).toContain("ApexClass:Foo");
+        expect(result.addedQnames).not.toContain("ApexClass:Foo");
+    });
+    it("detects added (new) ApexClass file", async () => {
+        w("force-app/main/default/classes/Brand.cls", "public class Brand {}");
+        const result = await analyzeLocalImpact({
+            graphStore: store,
+            orgId,
+            projectRoot,
+        });
+        expect(result.addedQnames).toContain("ApexClass:Brand");
+    });
+    it("full-folder mode detects removed (org-only) nodes", async () => {
+        store.mergeNodes([
+            seedNode("ApexClass:OnlyInOrg", "ApexClass"),
+            seedNode("ApexClass:Both", "ApexClass"),
+        ]);
+        w("force-app/main/default/classes/Both.cls", "public class Both {}");
+        const result = await analyzeLocalImpact({
+            graphStore: store,
+            orgId,
+            projectRoot,
+            mode: "full-folder",
+        });
+        expect(result.removedQnames).toContain("ApexClass:OnlyInOrg");
+        expect(result.removedQnames).not.toContain("ApexClass:Both");
+    });
+    it("finds dependents via reverse BFS", async () => {
+        // Persisted: Bar EXTENDS Foo. Foo also exists.
+        store.mergeNodes([
+            seedNode("ApexClass:Foo", "ApexClass"),
+            seedNode("ApexClass:Bar", "ApexClass"),
+        ]);
+        store.mergeEdges([seedEdge("ApexClass:Bar", "ApexClass:Foo", REL_TYPES.EXTENDS)]);
+        // Local change to Foo
+        w("force-app/main/default/classes/Foo.cls", "public class Foo { Integer x; }");
+        const result = await analyzeLocalImpact({
+            graphStore: store,
+            orgId,
+            projectRoot,
+        });
+        expect(result.changedQnames).toContain("ApexClass:Foo");
+        const depQnames = result.dependents.map((d) => d.qname);
+        expect(depQnames).toContain("ApexClass:Bar");
+    });
+    it("emits mermaid with WIP class defs and seed node id", async () => {
+        store.mergeNodes([seedNode("ApexClass:Foo", "ApexClass")]);
+        w("force-app/main/default/classes/Foo.cls", "public class Foo {}");
+        const result = await analyzeLocalImpact({
+            graphStore: store,
+            orgId,
+            projectRoot,
+        });
+        expect(result.mermaid).toContain("flowchart LR");
+        expect(result.mermaid).toContain("classDef wip-changed");
+        expect(result.mermaid).toContain("classDef wip-added");
+        expect(result.mermaid).toContain("classDef risk");
+        expect(result.mermaid).toContain("classDef safe");
+        // Some node id for ApexClass:Foo
+        expect(result.mermaid).toMatch(/ApexClass.?Foo/);
+    });
+});
+//# sourceMappingURL=wip-impact.test.js.map

package/dist/analyze/__tests__/wip-impact.test.js.map

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

package/dist/analyze/cross-org.d.ts

@@ -0,0 +1,42 @@
+import type { OrgId } from "@ryanstark24/sfgraph-shared";
+import type { NodeFact } from "../domain/index.js";
+import type { GraphStore } from "../storage/interfaces.js";
+export interface CrossOrgDiff {
+    onlyInA: NodeFact[];
+    onlyInB: NodeFact[];
+    changed: Array<{
+        a: NodeFact;
+        b: NodeFact;
+    }>;
+    /**
+     * True when at least one label-scan hit the per-label result cap
+     * (`CROSS_ORG_PER_LABEL_CAP`). Callers should warn the user and
+     * narrow the scope or paginate before drawing conclusions.
+     */
+    truncated?: boolean;
+}
+/**
+ * Per-label cap on cross-org node scans. Exported so callers can surface it
+ * verbatim in user-facing summaries.
+ */
+export declare const CROSS_ORG_PER_LABEL_CAP = 10000;
+export interface DiffOrgsArgs {
+    storeA: GraphStore;
+    orgA: OrgId;
+    storeB: GraphStore;
+    orgB: OrgId;
+    category?: string | "all";
+}
+/**
+ * Compute the set-difference between two ingested orgs.
+ *
+ * Each org has its own SQLite file, so cross-org diffs MUST be passed two
+ * `GraphStore` instances (one per org). Callers that historically passed a
+ * single store + two orgIds still work via the back-compat positional
+ * signature below, but that path is degenerate — both queries hit the same
+ * DB and will return an empty `onlyInB` whenever the second org's rows
+ * aren't present in store A.
+ */
+export declare function diffOrgs(args: DiffOrgsArgs): CrossOrgDiff;
+export declare function diffOrgs(store: GraphStore, orgA: OrgId, orgB: OrgId, category?: string | "all"): CrossOrgDiff;
+//# sourceMappingURL=cross-org.d.ts.map

package/dist/analyze/cross-org.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-org.d.ts","sourceRoot":"","sources":["../../src/analyze/cross-org.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,OAAO,EAAE,KAAK,CAAC;QAAE,CAAC,EAAE,QAAQ,CAAC;QAAC,CAAC,EAAE,QAAQ,CAAA;KAAE,CAAC,CAAC;IAC7C;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,QAAQ,CAAC;AAI7C,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,KAAK,CAAC;IACZ,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,KAAK,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAAC;AAC3D,wBAAgB,QAAQ,CACtB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,KAAK,EACX,IAAI,EAAE,KAAK,EACX,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,GACxB,YAAY,CAAC"}

package/dist/analyze/cross-org.js

@@ -0,0 +1,64 @@
+import { METADATA_CATEGORY } from "../domain/metadata-category.js";
+/**
+ * Per-label cap on cross-org node scans. Exported so callers can surface it
+ * verbatim in user-facing summaries.
+ */
+export const CROSS_ORG_PER_LABEL_CAP = 10000;
+const ALL_LABELS = Object.values(METADATA_CATEGORY);
+export function diffOrgs(storeOrArgs, maybeOrgA, maybeOrgB, maybeCategory = "all") {
+    let storeA;
+    let storeB;
+    let orgA;
+    let orgB;
+    let category;
+    if (typeof storeOrArgs === "object" &&
+        storeOrArgs !== null &&
+        "storeA" in storeOrArgs &&
+        "storeB" in storeOrArgs) {
+        const a = storeOrArgs;
+        storeA = a.storeA;
+        storeB = a.storeB;
+        orgA = a.orgA;
+        orgB = a.orgB;
+        category = a.category ?? "all";
+    }
+    else {
+        storeA = storeOrArgs;
+        storeB = storeOrArgs;
+        orgA = maybeOrgA;
+        orgB = maybeOrgB;
+        category = maybeCategory;
+    }
+    const labels = category === "all" ? ALL_LABELS : [category];
+    const aMap = new Map();
+    const bMap = new Map();
+    let truncated = false;
+    for (const lbl of labels) {
+        const aRows = storeA.listNodesByLabel(orgA, lbl, CROSS_ORG_PER_LABEL_CAP);
+        for (const n of aRows)
+            aMap.set(n.qualifiedName, n);
+        if (aRows.length >= CROSS_ORG_PER_LABEL_CAP)
+            truncated = true;
+        const bRows = storeB.listNodesByLabel(orgB, lbl, CROSS_ORG_PER_LABEL_CAP);
+        for (const n of bRows)
+            bMap.set(n.qualifiedName, n);
+        if (bRows.length >= CROSS_ORG_PER_LABEL_CAP)
+            truncated = true;
+    }
+    const onlyInA = [];
+    const onlyInB = [];
+    const changed = [];
+    for (const [k, a] of aMap) {
+        const b = bMap.get(k);
+        if (!b)
+            onlyInA.push(a);
+        else if (a.sourceHash !== b.sourceHash)
+            changed.push({ a, b });
+    }
+    for (const [k, b] of bMap) {
+        if (!aMap.has(k))
+            onlyInB.push(b);
+    }
+    return { onlyInA, onlyInB, changed, truncated };
+}
+//# sourceMappingURL=cross-org.js.map

package/dist/analyze/cross-org.js.map

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

package/dist/analyze/dead-code.d.ts

@@ -0,0 +1,8 @@
+import type { OrgId } from "@ryanstark24/sfgraph-shared";
+import type { NodeFact } from "../domain/index.js";
+import type { GraphStore } from "../storage/interfaces.js";
+/**
+ * Dead code = low freshness AND zero incoming edges.
+ */
+export declare function findDeadCode(store: GraphStore, orgId: OrgId): NodeFact[];
+//# sourceMappingURL=dead-code.d.ts.map

package/dist/analyze/dead-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-code.d.ts","sourceRoot":"","sources":["../../src/analyze/dead-code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAK3D;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,QAAQ,EAAE,CAYxE"}

package/dist/analyze/dead-code.js

@@ -0,0 +1,21 @@
+import { METADATA_CATEGORY } from "../domain/metadata-category.js";
+import { freshnessScore } from "./freshness.js";
+const SCAN_LABELS = [METADATA_CATEGORY.APEX_CLASS, METADATA_CATEGORY.LWC, METADATA_CATEGORY.FLOW];
+/**
+ * Dead code = low freshness AND zero incoming edges.
+ */
+export function findDeadCode(store, orgId) {
+    const now = Date.now();
+    const out = [];
+    for (const lbl of SCAN_LABELS) {
+        for (const n of store.listNodesByLabel(orgId, lbl, 5000)) {
+            if (freshnessScore(n, now) >= 0.4)
+                continue;
+            if (store.listEdgesTo(orgId, n.qualifiedName).length === 0) {
+                out.push(n);
+            }
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=dead-code.js.map

package/dist/analyze/dead-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-code.js","sourceRoot":"","sources":["../../src/analyze/dead-code.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,GAAG,CAAC,iBAAiB,CAAC,UAAU,EAAE,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;AAElG;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAiB,EAAE,KAAY;IAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;YACzD,IAAI,cAAc,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,GAAG;gBAAE,SAAS;YAC5C,IAAI,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3D,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/analyze/dependencies.d.ts

@@ -0,0 +1,5 @@
+import type { OrgId, QualifiedName } from "@ryanstark24/sfgraph-shared";
+import type { GraphStore } from "../storage/interfaces.js";
+import { type TraversalResult } from "./dependents.js";
+export declare function findDependencies(store: GraphStore, orgId: OrgId, qname: QualifiedName, depth?: number): TraversalResult;
+//# sourceMappingURL=dependencies.d.ts.map

package/dist/analyze/dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../src/analyze/dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAExE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAA8B,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AASnF,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,aAAa,EACpB,KAAK,SAAI,GACR,eAAe,CA6BjB"}

package/dist/analyze/dependencies.js

@@ -0,0 +1,40 @@
+import { TRAVERSAL_NODE_CAP_DEFAULT } from "./dependents.js";
+function nodeCap() {
+    const raw = process.env.SFGRAPH_TRAVERSAL_NODE_CAP;
+    if (!raw)
+        return TRAVERSAL_NODE_CAP_DEFAULT;
+    const n = Number.parseInt(raw, 10);
+    return Number.isFinite(n) && n > 0 ? n : TRAVERSAL_NODE_CAP_DEFAULT;
+}
+export function findDependencies(store, orgId, qname, depth = 3) {
+    const cap = nodeCap();
+    const visited = new Set();
+    const nodes = [];
+    const edges = [];
+    let frontier = [qname];
+    visited.add(qname);
+    let truncated = false;
+    bfs: for (let d = 0; d < depth && frontier.length > 0; d++) {
+        const next = [];
+        for (const cur of frontier) {
+            const outgoing = store.listEdgesFrom(orgId, cur);
+            for (const e of outgoing) {
+                edges.push(e);
+                if (!visited.has(e.dstQualifiedName)) {
+                    visited.add(e.dstQualifiedName);
+                    const n = store.getNode(orgId, e.dstQualifiedName);
+                    if (n)
+                        nodes.push(n);
+                    next.push(e.dstQualifiedName);
+                    if (visited.size >= cap) {
+                        truncated = true;
+                        break bfs;
+                    }
+                }
+            }
+        }
+        frontier = next;
+    }
+    return { nodes, edges, truncated };
+}
+//# sourceMappingURL=dependencies.js.map

package/dist/analyze/dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.js","sourceRoot":"","sources":["../../src/analyze/dependencies.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,0BAA0B,EAAwB,MAAM,iBAAiB,CAAC;AAEnF,SAAS,OAAO;IACd,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;IACnD,IAAI,CAAC,GAAG;QAAE,OAAO,0BAA0B,CAAC;IAC5C,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACnC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,0BAA0B,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAAiB,EACjB,KAAY,EACZ,KAAoB,EACpB,KAAK,GAAG,CAAC;IAET,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,IAAI,QAAQ,GAAoB,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnB,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,GAAG,EAAE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3D,MAAM,IAAI,GAAoB,EAAE,CAAC;QACjC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACjD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACzB,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACd,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,EAAE,CAAC;oBACrC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;oBAChC,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,gBAAgB,CAAC,CAAC;oBACnD,IAAI,CAAC;wBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBACrB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;oBAC9B,IAAI,OAAO,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;wBACxB,SAAS,GAAG,IAAI,CAAC;wBACjB,MAAM,GAAG,CAAC;oBACZ,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QACD,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AACrC,CAAC"}

package/dist/analyze/dependents.d.ts

@@ -0,0 +1,19 @@
+import type { OrgId, QualifiedName } from "@ryanstark24/sfgraph-shared";
+import type { EdgeFact, NodeFact } from "../domain/index.js";
+import type { GraphStore } from "../storage/interfaces.js";
+export interface TraversalResult {
+    nodes: NodeFact[];
+    edges: EdgeFact[];
+    /** Set when the traversal hit `NODE_CAP` before exhausting the graph. */
+    truncated?: boolean;
+}
+/**
+ * Hard ceiling on visited nodes per traversal. Prevents an agent — or a
+ * crafted call — from blowing memory by asking for depth=5 on a hub like
+ * `CustomObject:Account` or a heavily-referenced custom field.
+ *
+ * Override via `TRAVERSAL_NODE_CAP` env var if you really need more.
+ */
+export declare const TRAVERSAL_NODE_CAP_DEFAULT = 500;
+export declare function findDependents(store: GraphStore, orgId: OrgId, qname: QualifiedName, depth?: number): TraversalResult;
+//# sourceMappingURL=dependents.d.ts.map

package/dist/analyze/dependents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependents.d.ts","sourceRoot":"","sources":["../../src/analyze/dependents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,yEAAyE;IACzE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAQ9C,wBAAgB,cAAc,CAC5B,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,aAAa,EACpB,KAAK,SAAI,GACR,eAAe,CA6BjB"}

package/dist/analyze/dependents.js

@@ -0,0 +1,47 @@
+/**
+ * Hard ceiling on visited nodes per traversal. Prevents an agent — or a
+ * crafted call — from blowing memory by asking for depth=5 on a hub like
+ * `CustomObject:Account` or a heavily-referenced custom field.
+ *
+ * Override via `TRAVERSAL_NODE_CAP` env var if you really need more.
+ */
+export const TRAVERSAL_NODE_CAP_DEFAULT = 500;
+function nodeCap() {
+    const raw = process.env.SFGRAPH_TRAVERSAL_NODE_CAP;
+    if (!raw)
+        return TRAVERSAL_NODE_CAP_DEFAULT;
+    const n = Number.parseInt(raw, 10);
+    return Number.isFinite(n) && n > 0 ? n : TRAVERSAL_NODE_CAP_DEFAULT;
+}
+export function findDependents(store, orgId, qname, depth = 3) {
+    const cap = nodeCap();
+    const visited = new Set();
+    const nodes = [];
+    const edges = [];
+    let frontier = [qname];
+    visited.add(qname);
+    let truncated = false;
+    bfs: for (let d = 0; d < depth && frontier.length > 0; d++) {
+        const next = [];
+        for (const cur of frontier) {
+            const incoming = store.listEdgesTo(orgId, cur);
+            for (const e of incoming) {
+                edges.push(e);
+                if (!visited.has(e.srcQualifiedName)) {
+                    visited.add(e.srcQualifiedName);
+                    const n = store.getNode(orgId, e.srcQualifiedName);
+                    if (n)
+                        nodes.push(n);
+                    next.push(e.srcQualifiedName);
+                    if (visited.size >= cap) {
+                        truncated = true;
+                        break bfs;
+                    }
+                }
+            }
+        }
+        frontier = next;
+    }
+    return { nodes, edges, truncated };
+}
+//# sourceMappingURL=dependents.js.map

package/dist/analyze/dependents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependents.js","sourceRoot":"","sources":["../../src/analyze/dependents.ts"],"names":[],"mappings":"AAWA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAC9C,SAAS,OAAO;IACd,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;IACnD,IAAI,CAAC,GAAG;QAAE,OAAO,0BAA0B,CAAC;IAC5C,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACnC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,0BAA0B,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,KAAiB,EACjB,KAAY,EACZ,KAAoB,EACpB,KAAK,GAAG,CAAC;IAET,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,IAAI,QAAQ,GAAoB,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnB,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,GAAG,EAAE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3D,MAAM,IAAI,GAAoB,EAAE,CAAC;QACjC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC/C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACzB,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACd,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,EAAE,CAAC;oBACrC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;oBAChC,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,gBAAgB,CAAC,CAAC;oBACnD,IAAI,CAAC;wBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBACrB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;oBAC9B,IAAI,OAAO,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;wBACxB,SAAS,GAAG,IAAI,CAAC;wBACjB,MAAM,GAAG,CAAC;oBACZ,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QACD,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AACrC,CAAC"}

package/dist/analyze/deployment-manifest/generate.d.ts

@@ -0,0 +1,22 @@
+import type { OrgId } from "@ryanstark24/sfgraph-shared";
+import type { GraphStore } from "../../storage/interfaces.js";
+export interface DeploymentManifest {
+    packageXml: string;
+    destructiveXml: string;
+    summary: {
+        apiVersion: string;
+        addedOrChanged: number;
+        removed: number;
+        byType: Record<string, number>;
+    };
+}
+export interface GenerateManifestArgs {
+    storeA: GraphStore;
+    orgA: OrgId;
+    storeB: GraphStore;
+    orgB: OrgId;
+    category?: string;
+}
+export declare function generateManifest(args: GenerateManifestArgs): DeploymentManifest;
+export declare function generateManifest(store: GraphStore, orgA: OrgId, orgB: OrgId, category?: string): DeploymentManifest;
+//# sourceMappingURL=generate.d.ts.map

package/dist/analyze/deployment-manifest/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/analyze/deployment-manifest/generate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAK9D,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAChC,CAAC;CACH;AA6BD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,KAAK,CAAC;IACZ,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,KAAK,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,kBAAkB,CAAC;AACjF,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,KAAK,EACX,IAAI,EAAE,KAAK,EACX,QAAQ,CAAC,EAAE,MAAM,GAChB,kBAAkB,CAAC"}

package/dist/analyze/deployment-manifest/generate.js

@@ -0,0 +1,91 @@
+import { diffOrgs } from "../cross-org.js";
+import { formatMemberName } from "./member-name-formatters.js";
+import { LABEL_TO_METADATA_TYPE } from "./member-types.js";
+function escapeXml(s) {
+    return s
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+function buildPackage(members, apiVersion) {
+    const lines = ['<?xml version="1.0" encoding="UTF-8"?>'];
+    lines.push('<Package xmlns="http://soap.sforce.com/2006/04/metadata">');
+    const types = Array.from(members.keys()).sort();
+    for (const t of types) {
+        const set = members.get(t);
+        if (!set || set.size === 0)
+            continue;
+        lines.push("  <types>");
+        for (const m of Array.from(set).sort()) {
+            lines.push(`    <members>${escapeXml(m)}</members>`);
+        }
+        lines.push(`    <name>${t}</name>`);
+        lines.push("  </types>");
+    }
+    lines.push(`  <version>${escapeXml(apiVersion)}</version>`);
+    lines.push("</Package>");
+    return `${lines.join("\n")}\n`;
+}
+export function generateManifest(storeOrArgs, maybeOrgA, maybeOrgB, maybeCategory = "all") {
+    let storeA;
+    let storeB;
+    let orgA;
+    let orgB;
+    let category;
+    if (typeof storeOrArgs === "object" &&
+        storeOrArgs !== null &&
+        "storeA" in storeOrArgs &&
+        "storeB" in storeOrArgs) {
+        const a = storeOrArgs;
+        storeA = a.storeA;
+        storeB = a.storeB;
+        orgA = a.orgA;
+        orgB = a.orgB;
+        category = a.category ?? "all";
+    }
+    else {
+        storeA = storeOrArgs;
+        storeB = storeOrArgs;
+        orgA = maybeOrgA;
+        orgB = maybeOrgB;
+        category = maybeCategory;
+    }
+    const diff = diffOrgs({ storeA, orgA, storeB, orgB, category });
+    const apiVersion = storeA.getOrg(orgA)?.apiVersion ?? "59.0";
+    const pkgMembers = new Map();
+    const destMembers = new Map();
+    const byType = {};
+    const add = (target, label, qname) => {
+        const type = LABEL_TO_METADATA_TYPE[label];
+        if (!type)
+            return;
+        const name = formatMemberName(label, qname);
+        if (!name)
+            return;
+        let set = target.get(type);
+        if (!set) {
+            set = new Set();
+            target.set(type, set);
+        }
+        set.add(name);
+        byType[type] = (byType[type] ?? 0) + 1;
+    };
+    for (const n of diff.onlyInA)
+        add(pkgMembers, n.label, n.qualifiedName);
+    for (const { a } of diff.changed)
+        add(pkgMembers, a.label, a.qualifiedName);
+    for (const n of diff.onlyInB)
+        add(destMembers, n.label, n.qualifiedName);
+    return {
+        packageXml: buildPackage(pkgMembers, apiVersion),
+        destructiveXml: buildPackage(destMembers, apiVersion),
+        summary: {
+            apiVersion,
+            addedOrChanged: diff.onlyInA.length + diff.changed.length,
+            removed: diff.onlyInB.length,
+            byType,
+        },
+    };
+}
+//# sourceMappingURL=generate.js.map

package/dist/analyze/deployment-manifest/generate.js.map

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

package/dist/analyze/deployment-manifest/member-name-formatters.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Convert a sfgraph qualifiedName ("Label:Name" or "Label:Object.Field") into
+ * a package.xml member name (just the name portion, sometimes Object.Field).
+ */
+export type MemberNameFormatter = (qname: string) => string;
+export declare const FORMATTERS: Record<string, MemberNameFormatter>;
+export declare function formatMemberName(label: string, qname: string): string;
+//# sourceMappingURL=member-name-formatters.d.ts.map

package/dist/analyze/deployment-manifest/member-name-formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"member-name-formatters.d.ts","sourceRoot":"","sources":["../../../src/analyze/deployment-manifest/member-name-formatters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;AAe5D,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAyC1D,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrE"}

package/dist/analyze/deployment-manifest/member-name-formatters.js

@@ -0,0 +1,57 @@
+const STRIP_LABEL = (q) => {
+    const idx = q.indexOf(":");
+    return idx === -1 ? q : q.slice(idx + 1);
+};
+const OBJECT_DOT_FIELD = (q) => STRIP_LABEL(q); // "Account.Foo__c"
+const SHARING_RULES = (q) => {
+    // SharingRule:Account.Rule1 → Account
+    const after = STRIP_LABEL(q);
+    return after.split(".")[0] ?? after;
+};
+export const FORMATTERS = {
+    ApexClass: STRIP_LABEL,
+    ApexTrigger: STRIP_LABEL,
+    ApexPage: STRIP_LABEL,
+    ApexComponent: STRIP_LABEL,
+    LightningComponentBundle: STRIP_LABEL,
+    AuraDefinitionBundle: STRIP_LABEL,
+    Flow: STRIP_LABEL,
+    CustomObject: STRIP_LABEL,
+    CustomField: OBJECT_DOT_FIELD,
+    Profile: STRIP_LABEL,
+    PermissionSet: STRIP_LABEL,
+    PermissionSetGroup: STRIP_LABEL,
+    SharingRule: SHARING_RULES,
+    NamedCredential: STRIP_LABEL,
+    ExternalServiceRegistration: STRIP_LABEL,
+    PlatformEventChannel: STRIP_LABEL,
+    CustomLabel: STRIP_LABEL,
+    CustomMetadataType: STRIP_LABEL,
+    CustomMetadataRecord: STRIP_LABEL,
+    StaticResource: STRIP_LABEL,
+    Layout: STRIP_LABEL,
+    RecordType: OBJECT_DOT_FIELD,
+    ValidationRule: OBJECT_DOT_FIELD,
+    Workflow: STRIP_LABEL,
+    WorkflowRule: OBJECT_DOT_FIELD,
+    ApprovalProcess: STRIP_LABEL,
+    Queue: STRIP_LABEL,
+    Group: STRIP_LABEL,
+    Role: STRIP_LABEL,
+    ConnectedApp: STRIP_LABEL,
+    RemoteSiteSetting: STRIP_LABEL,
+    EmailTemplate: STRIP_LABEL,
+    Report: STRIP_LABEL,
+    Dashboard: STRIP_LABEL,
+    FlexiPage: STRIP_LABEL,
+    DuplicateRule: STRIP_LABEL,
+    MatchingRule: STRIP_LABEL,
+    Network: STRIP_LABEL,
+    GenAiPlanner: STRIP_LABEL,
+    GenAiPlugin: STRIP_LABEL,
+};
+export function formatMemberName(label, qname) {
+    const f = FORMATTERS[label] ?? STRIP_LABEL;
+    return f(qname);
+}
+//# sourceMappingURL=member-name-formatters.js.map

package/dist/analyze/deployment-manifest/member-name-formatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"member-name-formatters.js","sourceRoot":"","sources":["../../../src/analyze/deployment-manifest/member-name-formatters.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,GAAwB,CAAC,CAAC,EAAE,EAAE;IAC7C,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;AAC3C,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAwB,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB;AAExF,MAAM,aAAa,GAAwB,CAAC,CAAC,EAAE,EAAE;IAC/C,sCAAsC;IACtC,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAC7B,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC;AACtC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAwC;IAC7D,SAAS,EAAE,WAAW;IACtB,WAAW,EAAE,WAAW;IACxB,QAAQ,EAAE,WAAW;IACrB,aAAa,EAAE,WAAW;IAC1B,wBAAwB,EAAE,WAAW;IACrC,oBAAoB,EAAE,WAAW;IACjC,IAAI,EAAE,WAAW;IACjB,YAAY,EAAE,WAAW;IACzB,WAAW,EAAE,gBAAgB;IAC7B,OAAO,EAAE,WAAW;IACpB,aAAa,EAAE,WAAW;IAC1B,kBAAkB,EAAE,WAAW;IAC/B,WAAW,EAAE,aAAa;IAC1B,eAAe,EAAE,WAAW;IAC5B,2BAA2B,EAAE,WAAW;IACxC,oBAAoB,EAAE,WAAW;IACjC,WAAW,EAAE,WAAW;IACxB,kBAAkB,EAAE,WAAW;IAC/B,oBAAoB,EAAE,WAAW;IACjC,cAAc,EAAE,WAAW;IAC3B,MAAM,EAAE,WAAW;IACnB,UAAU,EAAE,gBAAgB;IAC5B,cAAc,EAAE,gBAAgB;IAChC,QAAQ,EAAE,WAAW;IACrB,YAAY,EAAE,gBAAgB;IAC9B,eAAe,EAAE,WAAW;IAC5B,KAAK,EAAE,WAAW;IAClB,KAAK,EAAE,WAAW;IAClB,IAAI,EAAE,WAAW;IACjB,YAAY,EAAE,WAAW;IACzB,iBAAiB,EAAE,WAAW;IAC9B,aAAa,EAAE,WAAW;IAC1B,MAAM,EAAE,WAAW;IACnB,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;IACtB,aAAa,EAAE,WAAW;IAC1B,YAAY,EAAE,WAAW;IACzB,OAAO,EAAE,WAAW;IACpB,YAAY,EAAE,WAAW;IACzB,WAAW,EAAE,WAAW;CACzB,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,KAAa;IAC3D,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC;IAC3C,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC;AAClB,CAAC"}