@acquis-consulting/asm 1.0.10 → 1.0.12

package/dist/utils/relatedComponents.js

@@ -0,0 +1,149 @@
+// Types that have a Description field queryable via Tooling API
+const TYPES_WITH_DESCRIPTION = new Set([
+    'ValidationRule',
+    'Flow',
+    'CustomField',
+    'LightningComponentBundle',
+    'PermissionSet',
+]);
+// Maps metadata type to a Tooling API query that resolves the component ID.
+// Returns null if the type is not supported.
+function buildIdQuery(metadataType, fullName) {
+    switch (metadataType) {
+        case 'ApexClass':
+            return `SELECT Id FROM ApexClass WHERE Name = '${esc(fullName)}'`;
+        case 'ApexTrigger':
+            return `SELECT Id FROM ApexTrigger WHERE Name = '${esc(fullName)}'`;
+        case 'Flow': {
+            const devName = fullName.split('-')[0]; // strip version suffix if present
+            return `SELECT Id FROM Flow WHERE DeveloperName = '${esc(devName)}' AND Status = 'Active' LIMIT 1`;
+        }
+        case 'CustomObject':
+            return `SELECT Id FROM EntityDefinition WHERE QualifiedApiName = '${esc(fullName)}'`;
+        case 'CustomField': {
+            const [obj, field] = splitDot(fullName);
+            if (!field)
+                return null;
+            return `SELECT Id FROM CustomField WHERE EntityDefinition.QualifiedApiName = '${esc(obj)}' AND DeveloperName = '${esc(field)}'`;
+        }
+        case 'ValidationRule': {
+            const [obj, rule] = splitDot(fullName);
+            if (!rule)
+                return null;
+            return `SELECT Id FROM ValidationRule WHERE EntityDefinition.QualifiedApiName = '${esc(obj)}' AND ValidationName = '${esc(rule)}'`;
+        }
+        case 'LightningComponentBundle':
+            return `SELECT Id FROM LightningComponentBundle WHERE DeveloperName = '${esc(fullName)}'`;
+        case 'AuraDefinitionBundle':
+            return `SELECT Id FROM AuraDefinitionBundle WHERE DeveloperName = '${esc(fullName)}'`;
+        case 'PermissionSet':
+            return `SELECT Id FROM PermissionSet WHERE Name = '${esc(fullName)}'`;
+        case 'Profile':
+            return `SELECT Id FROM Profile WHERE Name = '${esc(fullName)}'`;
+        default:
+            return null;
+    }
+}
+export async function resolveComponentId(conn, metadataType, fullName) {
+    const query = buildIdQuery(metadataType, fullName);
+    if (!query) {
+        console.error(`[relatedComponents] resolveComponentId: unsupported metadata type "${metadataType}"`);
+        return null;
+    }
+    try {
+        const result = await conn.tooling.query(query);
+        const record = result.records?.[0];
+        if (!record?.Id) {
+            console.error(`[relatedComponents] resolveComponentId: no record found for ${metadataType} "${fullName}"`);
+            return null;
+        }
+        return record.Id;
+    }
+    catch (err) {
+        console.error(`[relatedComponents] resolveComponentId failed for ${metadataType} "${fullName}": ${err.message}`);
+        return null;
+    }
+}
+export async function fetchRelatedComponents(conn, componentId) {
+    try {
+        const [parentsResult, childrenResult] = await Promise.all([
+            conn.tooling.query(`SELECT RefMetadataComponentId, RefMetadataComponentName, RefMetadataComponentType FROM MetadataComponentDependency WHERE MetadataComponentId = '${componentId}'`),
+            conn.tooling.query(`SELECT MetadataComponentId, MetadataComponentName, MetadataComponentType FROM MetadataComponentDependency WHERE RefMetadataComponentId = '${componentId}'`),
+        ]);
+        const seen = new Set();
+        const parents = [];
+        const children = [];
+        for (const r of (parentsResult.records || [])) {
+            if (!seen.has(r.RefMetadataComponentId)) {
+                seen.add(r.RefMetadataComponentId);
+                parents.push({ id: r.RefMetadataComponentId, apiName: r.RefMetadataComponentName, type: r.RefMetadataComponentType, description: null });
+            }
+        }
+        for (const r of (childrenResult.records || [])) {
+            if (!seen.has(r.MetadataComponentId)) {
+                seen.add(r.MetadataComponentId);
+                children.push({ id: r.MetadataComponentId, apiName: r.MetadataComponentName, type: r.MetadataComponentType, description: null });
+            }
+        }
+        return { parents, children };
+    }
+    catch (err) {
+        console.error(`[relatedComponents] fetchRelatedComponents failed for ${componentId}: ${err.message}`);
+        return { parents: [], children: [] };
+    }
+}
+export async function fetchDescriptions(conn, components) {
+    if (components.length === 0)
+        return components;
+    // Group by type, only for types that have a Description field
+    const byType = new Map();
+    for (const c of components) {
+        if (TYPES_WITH_DESCRIPTION.has(c.type)) {
+            if (!byType.has(c.type))
+                byType.set(c.type, []);
+            byType.get(c.type).push(c);
+        }
+    }
+    const descriptionMap = new Map();
+    await Promise.all(Array.from(byType.entries()).map(async ([type, comps]) => {
+        try {
+            const ids = comps.map((c) => `'${c.id}'`).join(',');
+            const result = await conn.tooling.query(`SELECT Id, Description FROM ${type} WHERE Id IN (${ids})`);
+            for (const r of (result.records || [])) {
+                descriptionMap.set(r.Id, r.Description ?? null);
+            }
+        }
+        catch (err) {
+            console.error(`[relatedComponents] fetchDescriptions failed for type ${type}: ${err.message}`);
+        }
+    }));
+    return components.map((c) => descriptionMap.has(c.id) ? { ...c, description: descriptionMap.get(c.id) } : c);
+}
+export function formatRelatedComponentsSection(parents, children) {
+    if (parents.length === 0 && children.length === 0)
+        return '';
+    const lines = ['', '## Related Components'];
+    if (parents.length > 0) {
+        lines.push('', '### Parents — what this component depends on');
+        for (const c of parents) {
+            lines.push(`- **${c.apiName}** (${c.type}) [${c.id}]${c.description ? ` — ${c.description}` : ''}`);
+        }
+    }
+    if (children.length > 0) {
+        lines.push('', '### Children — what depends on this component');
+        for (const c of children) {
+            lines.push(`- **${c.apiName}** (${c.type}) [${c.id}]${c.description ? ` — ${c.description}` : ''}`);
+        }
+    }
+    return lines.join('\n');
+}
+function esc(s) {
+    return s.replace(/'/g, "\\'");
+}
+function splitDot(fullName) {
+    const idx = fullName.indexOf('.');
+    if (idx === -1)
+        return [fullName, undefined];
+    return [fullName.slice(0, idx), fullName.slice(idx + 1)];
+}
+//# sourceMappingURL=relatedComponents.js.map

package/dist/utils/relatedComponents.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acquis-consulting/asm",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "description": "asm",
   "type": "module",
   "main": "dist/index.js",