@ryanstark24/sfgraph-core 1.1.0

package/dist/extractors/live-org/source-member.js

@@ -0,0 +1,47 @@
+import { METADATA_CATEGORY } from "../../domain/index.js";
+import { scheduleQuery } from "./rate-limit.js";
+const MEMBER_TYPE_TO_CATEGORY = {
+    ApexClass: METADATA_CATEGORY.APEX_CLASS,
+    ApexTrigger: METADATA_CATEGORY.APEX_TRIGGER,
+    ApexPage: METADATA_CATEGORY.APEX_PAGE,
+    ApexComponent: METADATA_CATEGORY.APEX_COMPONENT,
+    LightningComponentBundle: METADATA_CATEGORY.LWC,
+    AuraDefinitionBundle: METADATA_CATEGORY.AURA,
+    Flow: METADATA_CATEGORY.FLOW,
+    CustomObject: METADATA_CATEGORY.OBJECT,
+    CustomField: METADATA_CATEGORY.FIELD,
+    Profile: METADATA_CATEGORY.PROFILE,
+    PermissionSet: METADATA_CATEGORY.PERMISSION_SET,
+    NamedCredential: METADATA_CATEGORY.NAMED_CREDENTIAL,
+};
+/**
+ * Iterate over Salesforce Tooling SourceMember rows modified after `sinceIso`.
+ * Deletions surface with `obsolete: true` and an empty source URI suffix.
+ */
+export async function* iterChanges(conn, _orgId, sinceIso) {
+    // Salesforce SOQL datetime literals are unquoted ISO-8601 (e.g. 2025-01-01T00:00:00Z).
+    const since = sinceIso.replace(/'/g, "");
+    const baseSoql = `SELECT Id, MemberType, MemberName, RevisionCounter, IsNameObsolete, LastModifiedDate FROM SourceMember WHERE LastModifiedDate > ${since} ORDER BY LastModifiedDate ASC`;
+    let result = await scheduleQuery(() => conn.tooling.query(baseSoql));
+    while (result) {
+        const records = (result.records ?? []);
+        for (const r of records) {
+            const category = MEMBER_TYPE_TO_CATEGORY[r.MemberType];
+            if (!category)
+                continue;
+            yield {
+                category,
+                memberType: r.MemberType,
+                memberName: r.MemberName,
+                lastModifiedAt: r.LastModifiedDate,
+                sourceUri: `sf://tooling/${r.MemberType}/${r.MemberName}`,
+                obsolete: Boolean(r.IsNameObsolete),
+            };
+        }
+        if (result.done || !result.nextRecordsUrl || typeof conn.tooling.queryMore !== "function") {
+            break;
+        }
+        result = await scheduleQuery(() => conn.tooling.queryMore(result.nextRecordsUrl));
+    }
+}
+//# sourceMappingURL=source-member.js.map

package/dist/extractors/live-org/source-member.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-member.js","sourceRoot":"","sources":["../../../src/extractors/live-org/source-member.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAyB,MAAM,uBAAuB,CAAC;AAEjF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAWhD,MAAM,uBAAuB,GAAqC;IAChE,SAAS,EAAE,iBAAiB,CAAC,UAAU;IACvC,WAAW,EAAE,iBAAiB,CAAC,YAAY;IAC3C,QAAQ,EAAE,iBAAiB,CAAC,SAAS;IACrC,aAAa,EAAE,iBAAiB,CAAC,cAAc;IAC/C,wBAAwB,EAAE,iBAAiB,CAAC,GAAG;IAC/C,oBAAoB,EAAE,iBAAiB,CAAC,IAAI;IAC5C,IAAI,EAAE,iBAAiB,CAAC,IAAI;IAC5B,YAAY,EAAE,iBAAiB,CAAC,MAAM;IACtC,WAAW,EAAE,iBAAiB,CAAC,KAAK;IACpC,OAAO,EAAE,iBAAiB,CAAC,OAAO;IAClC,aAAa,EAAE,iBAAiB,CAAC,cAAc;IAC/C,eAAe,EAAE,iBAAiB,CAAC,gBAAgB;CACpD,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,WAAW,CAChC,IAAS,EACT,MAAa,EACb,QAAgB;IAEhB,uFAAuF;IACvF,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,mIAAmI,KAAK,gCAAgC,CAAC;IAE1L,IAAI,MAAM,GAAQ,MAAM,aAAa,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC1E,OAAO,MAAM,EAAE,CAAC;QACd,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAsB,CAAC;QAC5D,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,QAAQ,GAAG,uBAAuB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;YACvD,IAAI,CAAC,QAAQ;gBAAE,SAAS;YACxB,MAAM;gBACJ,QAAQ;gBACR,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,cAAc,EAAE,CAAC,CAAC,gBAAgB;gBAClC,SAAS,EAAE,gBAAgB,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,UAAU,EAAE;gBACzD,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC;aACpC,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;YAC1F,MAAM;QACR,CAAC;QACD,MAAM,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;IACpF,CAAC;AACH,CAAC"}

package/dist/extractors/live-org/vlocity/query-definitions.yml

@@ -0,0 +1,153 @@
+# Vendored from vlocityinc/vlocity_build (MIT) on 2026-05-13T20:00:35Z
+# Upstream: https://github.com/vlocityinc/vlocity_build/blob/master/dataPacksJobs/QueryDefinitions.yaml
+# Do not edit by hand. Re-sync via scripts/refresh-vlocity-registry.ts
+
+# Shared Query Definitions. You can use these in your job file by just using the key:
+# queries:
+#  - CalculationMatrix
+#  - OmniScript
+AttributeAssignmentRule:
+  VlocityDataPackType: AttributeAssignmentRule
+  query: Select Id, Name from %vlocity_namespace%__AttributeAssignmentRule__c
+AttributeCategory:
+  VlocityDataPackType: AttributeCategory
+  query: Select Id, Name, %vlocity_namespace%__Code__c from %vlocity_namespace%__AttributeCategory__c
+CalculationMatrix:
+  VlocityDataPackType: CalculationMatrix
+  query: Select Id, Name from %vlocity_namespace%__CalculationMatrix__c
+CalculationProcedure:
+  VlocityDataPackType: CalculationProcedure
+  query: Select Id, Name from %vlocity_namespace%__CalculationProcedure__c
+Catalog:
+  VlocityDataPackType: Catalog
+  query: Select Id, Name from %vlocity_namespace%__Catalog__c     
+ContextAction:
+  VlocityDataPackType: ContextAction
+  query: Select Id, Name, %vlocity_namespace%__GlobalKey__c from %vlocity_namespace%__ContextAction__c
+ContextDimension:
+  VlocityDataPackType: ContextDimension
+  query: Select Id, Name, %vlocity_namespace%__GlobalKey__c from %vlocity_namespace%__ContextDimension__c
+ContextScope:
+  VlocityDataPackType: ContextScope
+  query: Select Id, Name, %vlocity_namespace%__GlobalKey__c from %vlocity_namespace%__ContextScope__c
+ContractType:
+  VlocityDataPackType: ContractType
+  query: Select Id, Name from %vlocity_namespace%__ContractType__c
+DataRaptor:
+  VlocityDataPackType: DataRaptor
+  query: Select Id, Name from %vlocity_namespace%__DRBundle__c where %vlocity_namespace%__Type__c != 'Migration'
+DocumentClause:
+  VlocityDataPackType: DocumentClause
+  query: Select Id, Name from %vlocity_namespace%__DocumentClause__c
+DocumentTemplate:
+  VlocityDataPackType: DocumentTemplate
+  query: Select Id, Name from %vlocity_namespace%__DocumentTemplate__c
+EntityFilter:
+  VlocityDataPackType: EntityFilter
+  query: Select Id, Name, %vlocity_namespace%__GlobalKey__c from %vlocity_namespace%__EntityFilter__c
+IntegrationProcedure:
+  VlocityDataPackType: IntegrationProcedure
+  query: Select Id, %vlocity_namespace%__Type__c, %vlocity_namespace%__SubType__c from %vlocity_namespace%__OmniScript__c where %vlocity_namespace%__IsActive__c
+    = true AND %vlocity_namespace%__IsProcedure__c = true
+InterfaceImplementation:
+  VlocityDataPackType: InterfaceImplementation
+  query: Select Id, Name from %vlocity_namespace%__InterfaceImplementation__c    
+ItemImplementation:
+  VlocityDataPackType: ItemImplementation
+  query: Select Id, Name from %vlocity_namespace%__ItemImplementation__c
+ManualQueue:
+  VlocityDataPackType: ManualQueue
+  query: Select Id, Name from %vlocity_namespace%__ManualQueue__c
+ObjectClass:
+  VlocityDataPackType: ObjectClass
+  query: Select Id, Name, %vlocity_namespace%__GlobalKey__c from %vlocity_namespace%__ObjectClass__c
+ObjectContextRule:
+  VlocityDataPackType: ObjectContextRule
+  query: Select Id, Name from %vlocity_namespace%__ObjectRuleAssignment__c
+ObjectLayout:
+  VlocityDataPackType: ObjectLayout
+  query: Select Id, Name, %vlocity_namespace%__GlobalKey__c from %vlocity_namespace%__ObjectLayout__c
+OmniScript:
+  VlocityDataPackType: OmniScript
+  query: Select Id, %vlocity_namespace%__Type__c, %vlocity_namespace%__SubType__c, %vlocity_namespace%__Language__c from %vlocity_namespace%__OmniScript__c where %vlocity_namespace%__IsActive__c = true AND %vlocity_namespace%__IsProcedure__c = false
+OrchestrationDependencyDefinition:
+  VlocityDataPackType: OrchestrationDependencyDefinition
+  query: Select Id, Name, %vlocity_namespace%__GlobalKey__c from %vlocity_namespace%__OrchestrationDependencyDefinition__c
+OrchestrationItemDefinition:
+  VlocityDataPackType: OrchestrationItemDefinition
+  query: Select Id, Name from %vlocity_namespace%__OrchestrationItemDefinition__c
+OrchestrationPlanDefinition:
+  VlocityDataPackType: OrchestrationPlanDefinition
+  query: Select Id, Name from %vlocity_namespace%__OrchestrationPlanDefinition__c
+PriceList:
+  VlocityDataPackType: PriceList
+  query: Select Id, Name, %vlocity_namespace%__Code__c from %vlocity_namespace%__PriceList__c
+Pricebook2:
+  VlocityDataPackType: Pricebook2
+  query: Select Id, Name from Pricebook2
+PricingPlan:
+  VlocityDataPackType: PricingPlan
+  query: Select Id, Name from %vlocity_namespace%__PricingPlan__c
+PricingVariable:
+  VlocityDataPackType: PricingVariable
+  query: Select Id, Name, %vlocity_namespace%__Code__c from %vlocity_namespace%__PricingVariable__c
+Product2:   
+  VlocityDataPackType: Product2
+  query: Select Id, Name, %vlocity_namespace%__GlobalKey__c from Product2
+Promotion:
+  VlocityDataPackType: Promotion
+  query: Select Id, Name, %vlocity_namespace%__GlobalKey__c from %vlocity_namespace%__Promotion__c
+QueryBuilder:
+  VlocityDataPackType: QueryBuilder
+  query: Select Id from %vlocity_namespace%__QueryBuilder__c
+Rule:
+  VlocityDataPackType: Rule
+  query: Select Id, Name, %vlocity_namespace%__GlobalKey__c from %vlocity_namespace%__Rule__c
+StoryObjectConfiguration:
+  VlocityDataPackType: StoryObjectConfiguration
+  query: Select Id, Name from %vlocity_namespace%__StoryObjectConfiguration__c
+System:
+  VlocityDataPackType: System
+  query: Select Id, Name from %vlocity_namespace%__System__c
+TimePlan:
+  VlocityDataPackType: TimePlan
+  query: Select Id, Name, %vlocity_namespace%__GlobalKey__c from %vlocity_namespace%__TimePlan__c
+TimePolicy:
+  VlocityDataPackType: TimePolicy
+  query: Select Id, Name, %vlocity_namespace%__GlobalKey__c from %vlocity_namespace%__TimePolicy__c
+UIFacet:
+  VlocityDataPackType: UIFacet
+  query: Select Id, Name, %vlocity_namespace%__GlobalKey__c from %vlocity_namespace%__UIFacet__c
+UISection:
+  VlocityDataPackType: UISection
+  query: Select Id, Name, %vlocity_namespace%__GlobalKey__c from %vlocity_namespace%__UISection__c
+VlocityAction:
+  VlocityDataPackType: VlocityAction
+  query: SELECT Id, Name FROM %vlocity_namespace%__VlocityAction__c where %vlocity_namespace%__IsActive__c = true
+VlocityCard:
+  VlocityDataPackType: VlocityCard
+  query: SELECT Id, Name FROM %vlocity_namespace%__VlocityCard__c where %vlocity_namespace%__Active__c = true
+VlocityFunction:
+  VlocityDataPackType: VlocityFunction
+  query: Select Id, Name, %vlocity_namespace%__GlobalKey__c from %vlocity_namespace%__VlocityFunction__c
+VlocityPicklist:
+  VlocityDataPackType: VlocityPicklist
+  query: Select Id, Name, %vlocity_namespace%__GlobalKey__c from %vlocity_namespace%__Picklist__c
+VlocitySearchWidgetSetup:
+  VlocityDataPackType: VlocitySearchWidgetSetup
+  query: Select Id, Name from %vlocity_namespace%__VlocitySearchWidgetSetup__c
+VlocityStateModel:
+  VlocityDataPackType: VlocityStateModel
+  query: Select Id, Name from %vlocity_namespace%__VlocityStateModel__c
+VlocityUILayout:
+  VlocityDataPackType: VlocityUILayout
+  query: Select Id, Name from %vlocity_namespace%__VlocityUILayout__c where %vlocity_namespace%__Active__c = true
+VlocityUITemplate:
+  VlocityDataPackType: VlocityUITemplate
+  query: Select Id, Name from %vlocity_namespace%__VlocityUITemplate__c where %vlocity_namespace%__Active__c = true
+VqMachine:
+  VlocityDataPackType: VqMachine
+  query: Select Id, Name from %vlocity_namespace%__VqMachine__c
+VqResource:
+  VlocityDataPackType: VqResource
+  query: Select Id, Name from %vlocity_namespace%__VqResource__c

package/dist/extractors/live-org/vlocity/runner.d.ts

@@ -0,0 +1,21 @@
+import type { RawMember } from "../../interfaces/metadata-source.js";
+import type { OrgCapabilities } from "../capabilities.js";
+export interface VlocityTypeDef {
+    vlocityDataPackType: string;
+    /** Raw SOQL with `%vlocity_namespace%` placeholder. */
+    query: string;
+}
+/** Load and cache the vendored Vlocity DataPack query registry. */
+export declare function loadVlocityRegistry(): Record<string, VlocityTypeDef>;
+/**
+ * Yield a RawMember per record across every detected Vlocity namespace and every
+ * registry entry. Namespace substitution is `%vlocity_namespace%` → `<ns>`.
+ *
+ * For datapack types listed in CHILD_FETCHES, also fetches the element
+ * graph (Element__c / DRMapItem__c) and attaches it under the configured
+ * key — without this enrichment the parsers find zero inner nodes and
+ * emit zero edges, so Vlocity nodes exist in the graph but have no
+ * relationships.
+ */
+export declare function iterVlocityRecords(conn: any, caps: OrgCapabilities, orgId: string): AsyncIterable<RawMember>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/extractors/live-org/vlocity/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../../src/extractors/live-org/vlocity/runner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,MAAM,WAAW,cAAc;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;CACf;AAYD,mEAAmE;AACnE,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAgBpE;AA8JD;;;;;;;;;GASG;AACH,wBAAuB,kBAAkB,CACvC,IAAI,EAAE,GAAG,EACT,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,MAAM,GACZ,aAAa,CAAC,SAAS,CAAC,CAkD1B"}

package/dist/extractors/live-org/vlocity/runner.js

@@ -0,0 +1,214 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { parse as parseYaml } from "yaml";
+import { METADATA_CATEGORY } from "../../../domain/index.js";
+import { scheduleQuery } from "../rate-limit.js";
+const HERE = dirname(fileURLToPath(import.meta.url));
+const REGISTRY_PATH = join(HERE, "query-definitions.yml");
+let CACHED_REGISTRY = null;
+/** Load and cache the vendored Vlocity DataPack query registry. */
+export function loadVlocityRegistry() {
+    if (CACHED_REGISTRY)
+        return CACHED_REGISTRY;
+    const text = readFileSync(REGISTRY_PATH, "utf8");
+    const parsed = parseYaml(text);
+    const out = {};
+    if (parsed && typeof parsed === "object") {
+        for (const [key, value] of Object.entries(parsed)) {
+            if (!value || typeof value !== "object")
+                continue;
+            const vdpType = value.VlocityDataPackType;
+            const query = value.query;
+            if (typeof vdpType !== "string" || typeof query !== "string")
+                continue;
+            out[key] = { vlocityDataPackType: vdpType, query };
+        }
+    }
+    CACHED_REGISTRY = out;
+    return out;
+}
+/** Strip a Vlocity namespace prefix + `__c` suffix so the parser walk sees
+ *  the conventional keys (`Type`, `propertySet`, `Definition`, …) instead
+ *  of `vlocity_cmt__Type__c` etc. Keeps `Id`, `Name`, `LastModifiedDate`
+ *  intact. */
+function normaliseFieldName(key, namespace) {
+    let k = key;
+    if (k.startsWith(`${namespace}__`))
+        k = k.slice(namespace.length + 2);
+    if (k.endsWith("__c") || k.endsWith("__r"))
+        k = k.slice(0, -3);
+    return k;
+}
+/** Parse a long-text JSON field value defensively — Vlocity stores design-
+ *  time config as stringified JSON; if parsing fails we keep the raw text
+ *  under `_raw` so a parser fallback can still see something. */
+function tryParseJsonField(value) {
+    if (typeof value !== "string" || value.length === 0)
+        return null;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return { _raw: value };
+    }
+}
+/** Normalise every key on a row (strip namespace prefix) and decode the
+ *  known JSON-blob fields (`PropertySet`, `Definition`, `Content`,
+ *  `DefinitionFileContent`). Returns a plain object the parsers' walk()
+ *  can traverse. */
+function normaliseRow(row, namespace) {
+    const out = {};
+    for (const [k, v] of Object.entries(row)) {
+        const key = normaliseFieldName(k, namespace);
+        out[key] = v;
+    }
+    for (const blobKey of ["PropertySet", "Definition", "Content", "DefinitionFileContent"]) {
+        if (typeof out[blobKey] === "string") {
+            const parsed = tryParseJsonField(out[blobKey]);
+            if (parsed !== null)
+                out[blobKey] = parsed;
+        }
+    }
+    // Surface `propertySet` under the lowercase key the parsers check for.
+    if (out.PropertySet !== undefined && out.propertySet === undefined) {
+        out.propertySet = out.PropertySet;
+    }
+    return out;
+}
+/** Datapack-type-specific child queries. Only types with non-empty entries
+ *  produce edges in the parser walk. Anything not listed yields a parent-
+ *  only row (which is still useful as a node). */
+const CHILD_FETCHES = {
+    OmniScript: {
+        soql: (ns, ids) => `SELECT Id, Name, ${ns}__Type__c, ${ns}__PropertySet__c, ${ns}__OmniScriptId__c FROM ${ns}__Element__c WHERE ${ns}__OmniScriptId__c IN (${ids})`,
+        parentField: "OmniScriptId",
+        attachAs: "elements",
+    },
+    IntegrationProcedure: {
+        // Same Element__c table; IntegrationProcedures are OmniScripts with
+        // IsProcedure__c = true.
+        soql: (ns, ids) => `SELECT Id, Name, ${ns}__Type__c, ${ns}__PropertySet__c, ${ns}__OmniScriptId__c FROM ${ns}__Element__c WHERE ${ns}__OmniScriptId__c IN (${ids})`,
+        parentField: "OmniScriptId",
+        attachAs: "elements",
+    },
+    DataRaptor: {
+        soql: (ns, ids) => `SELECT Id, Name, ${ns}__InputFieldName__c, ${ns}__OutputFieldName__c, ${ns}__DRBundleId__c FROM ${ns}__DRMapItem__c WHERE ${ns}__DRBundleId__c IN (${ids})`,
+        parentField: "DRBundleId",
+        attachAs: "mapItems",
+    },
+};
+/** Long-text fields that need to be SELECTed explicitly per-type because
+ *  the vendored vlocity_build registry omits them. Keyed by VlocityDataPackType. */
+const EXTRA_BLOB_FIELDS = {
+    OmniScript: ["PropertySet__c"],
+    IntegrationProcedure: ["PropertySet__c"],
+    VlocityCard: ["Definition__c", "Active__c"],
+    DataRaptor: ["Type__c", "InputType__c", "OutputType__c"],
+};
+/** Build an enriched SOQL by appending the missing blob columns. We do this
+ *  as a textual rewrite of the registry's SELECT clause rather than parsing
+ *  SOQL — preserves the existing namespace placeholder substitution. */
+function enrichSoql(baseSoql, vdpType, namespace) {
+    const extras = EXTRA_BLOB_FIELDS[vdpType];
+    if (!extras || extras.length === 0)
+        return baseSoql;
+    const cols = extras.map((c) => `${namespace}__${c}`).join(", ");
+    // Insert before the first " from " (case-insensitive). Be tolerant of
+    // both quoting / casing variants used in the vendored YAML.
+    return baseSoql.replace(/(\s+from\s+)/i, `, ${cols}$1`);
+}
+/**
+ * Fetch element children (one query per type-namespace pair) and group by
+ * parent Id. Runs only for types listed in CHILD_FETCHES. Without this,
+ * the parser walk() for OmniScript/IntegrationProcedure/DataRaptor finds
+ * zero element nodes and emits zero IP_CALLS_DR / OS_USES_DR / DR_READS_FIELD
+ * edges — Vlocity nodes exist in isolation.
+ */
+async function fetchChildrenByParent(conn, vdpType, namespace, parentIds) {
+    const byParent = new Map();
+    const spec = CHILD_FETCHES[vdpType];
+    if (!spec || parentIds.length === 0)
+        return byParent;
+    const CHUNK = 200;
+    for (let i = 0; i < parentIds.length; i += CHUNK) {
+        const slice = parentIds.slice(i, i + CHUNK);
+        const idList = slice.map((id) => `'${id.replace(/'/g, "\\'")}'`).join(",");
+        const soql = spec.soql(namespace, idList);
+        let res = null;
+        try {
+            res = (await scheduleQuery(() => conn.query(soql)));
+        }
+        catch {
+            continue;
+        }
+        for (const r of res?.records ?? []) {
+            const norm = normaliseRow(r, namespace);
+            const parentId = String(norm[spec.parentField] ?? "");
+            if (!parentId)
+                continue;
+            const arr = byParent.get(parentId) ?? [];
+            arr.push(norm);
+            byParent.set(parentId, arr);
+        }
+    }
+    return byParent;
+}
+/**
+ * Yield a RawMember per record across every detected Vlocity namespace and every
+ * registry entry. Namespace substitution is `%vlocity_namespace%` → `<ns>`.
+ *
+ * For datapack types listed in CHILD_FETCHES, also fetches the element
+ * graph (Element__c / DRMapItem__c) and attaches it under the configured
+ * key — without this enrichment the parsers find zero inner nodes and
+ * emit zero edges, so Vlocity nodes exist in the graph but have no
+ * relationships.
+ */
+export async function* iterVlocityRecords(conn, caps, orgId) {
+    const namespaces = caps.vlocityNamespaces ?? [];
+    if (namespaces.length === 0)
+        return;
+    const registry = loadVlocityRegistry();
+    const entries = Object.values(registry);
+    for (const namespace of namespaces) {
+        for (const typeDef of entries) {
+            const baseSoql = typeDef.query.split("%vlocity_namespace%").join(namespace);
+            const soql = enrichSoql(baseSoql, typeDef.vlocityDataPackType, namespace);
+            let res = null;
+            try {
+                res = (await scheduleQuery(() => conn.query(soql)));
+            }
+            catch {
+                continue;
+            }
+            const records = res?.records ?? [];
+            // Two-pass for types with element children: collect parent Ids,
+            // batch-fetch children, then yield enriched parents.
+            const childSpec = CHILD_FETCHES[typeDef.vlocityDataPackType];
+            const childrenByParent = childSpec
+                ? await fetchChildrenByParent(conn, typeDef.vlocityDataPackType, namespace, records.map((r) => String(r.Id ?? "")).filter((id) => id.length > 0))
+                : new Map();
+            for (const r of records) {
+                const name = String(r.Name ?? r.Id ?? "");
+                const normalised = normaliseRow(r, namespace);
+                if (childSpec && r.Id) {
+                    const kids = childrenByParent.get(String(r.Id));
+                    if (kids && kids.length > 0)
+                        normalised[childSpec.attachAs] = kids;
+                }
+                yield {
+                    ref: {
+                        category: METADATA_CATEGORY.VLOCITY,
+                        memberType: typeDef.vlocityDataPackType,
+                        memberName: name,
+                        lastModifiedAt: r.LastModifiedDate ?? "",
+                        sourceUri: `sf://${orgId}/${typeDef.vlocityDataPackType}/${name}`,
+                        namespace,
+                    },
+                    content: JSON.stringify(normalised),
+                };
+            }
+        }
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/extractors/live-org/vlocity/runner.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./domain/index.js";
+export * from "./telemetry/index.js";
+export * from "./extractors/live-org/index.js";
+export * from "./storage/index.js";
+export * from "./ingest/index.js";
+export type { MetadataSource, MemberRef, RawMember, } from "./extractors/interfaces/metadata-source.js";
+export { FilesystemMetadataSource } from "./extractors/filesystem/index.js";
+export * as render from "./render/mermaid/index.js";
+export * as analyze from "./analyze/index.js";
+export type { ToolResponse } from "./tools/types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,YAAY,EACV,cAAc,EACd,SAAS,EACT,SAAS,GACV,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AACpD,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export * from "./domain/index.js";
+export * from "./telemetry/index.js";
+export * from "./extractors/live-org/index.js";
+export * from "./storage/index.js";
+export * from "./ingest/index.js";
+export { FilesystemMetadataSource } from "./extractors/filesystem/index.js";
+export * as render from "./render/mermaid/index.js";
+export * as analyze from "./analyze/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAMlC,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AACpD,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC"}

package/dist/ingest/__tests__/full-sync-deletion.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=full-sync-deletion.test.d.ts.map

package/dist/ingest/__tests__/full-sync-deletion.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"full-sync-deletion.test.d.ts","sourceRoot":"","sources":["../../../src/ingest/__tests__/full-sync-deletion.test.ts"],"names":[],"mappings":""}