@jterrats/smart-deployment 1.0.3

package/lib/parsers/aura-parser.d.ts

@@ -0,0 +1,55 @@
+import type { AuraComponentMetadata, AuraComponentType } from '../types/salesforce/aura.js';
+/**
+ * Aura dependency types
+ */
+export type AuraDependencyType = 'apex_controller' | 'child_component' | 'event' | 'interface' | 'extends' | 'helper';
+/**
+ * Represents a dependency found in an Aura component
+ */
+export type AuraDependency = {
+    type: AuraDependencyType;
+    name: string;
+    namespace?: string;
+};
+/**
+ * Result of parsing an Aura component
+ * Optionally includes metadata from .cmp-meta.xml, .app-meta.xml, etc.
+ */
+export type AuraParseResult = {
+    componentName: string;
+    componentType: AuraComponentType;
+    apexController?: string;
+    extendsComponent?: string;
+    implementsInterfaces: string[];
+    childComponents: string[];
+    events: string[];
+    dependencies: AuraDependency[];
+    hasController: boolean;
+    hasHelper: boolean;
+    hasStyle: boolean;
+    metadata?: AuraComponentMetadata;
+};
+/**
+ * Parse an Aura component and extract dependencies
+ *
+ * @param componentName - Name of the Aura component
+ * @param cmpContent - Content of the .cmp file
+ * @param hasController - Whether the component has a controller.js file
+ * @param hasHelper - Whether the component has a helper.js file
+ * @param hasStyle - Whether the component has a style.css file
+ * @returns AuraParseResult with all extracted dependencies
+ *
+ * @throws {ParsingError} If the component cannot be parsed
+ *
+ * @ac US-017-AC-6: Validate bundle structure
+ * @ac US-017-AC-7: Parse all bundle files (.cmp, .js, .css, etc.)
+ *
+ * @example
+ * ```typescript
+ * const result = parseAura('MyComponent', cmpContent, true, true, false);
+ * console.log(result.apexController); // 'MyController'
+ * console.log(result.childComponents); // ['c:ChildComponent']
+ * console.log(result.events); // ['c:MyEvent']
+ * ```
+ */
+export declare function parseAura(componentName: string, cmpContent: string, hasController?: boolean, hasHelper?: boolean, hasStyle?: boolean): AuraParseResult;

package/lib/parsers/aura-parser.js

@@ -0,0 +1,229 @@
+import { getLogger } from '../utils/logger.js';
+import { ParsingError } from '../errors/parsing-error.js';
+const logger = getLogger('AuraParser');
+/**
+ * Extract Apex controller from component markup
+ *
+ * @ac US-017-AC-1: Extract controller Apex class
+ */
+function extractApexController(cmpXml) {
+    // Pattern: controller="MyController" or controller="ns__MyController"
+    const controllerMatch = cmpXml.match(/controller\s*=\s*["']([a-zA-Z][a-zA-Z0-9_.]*?)["']/);
+    return controllerMatch ? controllerMatch[1] : undefined;
+}
+/**
+ * Extract component extends relationship
+ *
+ * @ac US-017-AC-5: Extract interface implementations (also handles extends)
+ */
+function extractExtends(cmpXml) {
+    // Pattern: extends="c:BaseComponent" or extends="namespace:BaseComponent"
+    const extendsMatch = cmpXml.match(/extends\s*=\s*["']([a-zA-Z][a-zA-Z0-9_:]*?)["']/);
+    return extendsMatch ? extendsMatch[1] : undefined;
+}
+/**
+ * Extract interface implementations
+ *
+ * @ac US-017-AC-5: Extract interface implementations
+ */
+function extractImplements(cmpXml) {
+    // Pattern: implements="flexipage:availableForAllPageTypes,force:hasRecordId"
+    const implementsMatch = cmpXml.match(/implements\s*=\s*["']([^"']+)["']/);
+    if (!implementsMatch) {
+        return [];
+    }
+    return implementsMatch[1]
+        .split(',')
+        .map((impl) => impl.trim())
+        .filter((impl) => impl.length > 0);
+}
+/**
+ * Extract child component references
+ *
+ * @ac US-017-AC-3: Extract child component references
+ */
+function extractChildComponents(cmpXml) {
+    const children = [];
+    // Pattern: <c:ChildComponent ... /> or <namespace:ComponentName ... />
+    const componentPattern = /<([a-zA-Z][a-zA-Z0-9_]*):([a-zA-Z][a-zA-Z0-9_]*)[^>]*\/>/g;
+    const matches = cmpXml.matchAll(componentPattern);
+    for (const match of matches) {
+        const namespace = match[1];
+        const componentName = match[2];
+        // Exclude aura: namespace (framework components)
+        if (namespace !== 'aura' && namespace !== 'lightning' && namespace !== 'ui') {
+            const fullName = `${namespace}:${componentName}`;
+            if (!children.includes(fullName)) {
+                children.push(fullName);
+            }
+        }
+    }
+    // Also check for non-self-closing tags: <c:ChildComponent>...</c:ChildComponent>
+    const openTagPattern = /<([a-zA-Z][a-zA-Z0-9_]*):([a-zA-Z][a-zA-Z0-9_]*)[^/>]*>/g;
+    const openMatches = cmpXml.matchAll(openTagPattern);
+    for (const match of openMatches) {
+        const namespace = match[1];
+        const componentName = match[2];
+        if (namespace !== 'aura' && namespace !== 'lightning' && namespace !== 'ui') {
+            const fullName = `${namespace}:${componentName}`;
+            if (!children.includes(fullName)) {
+                children.push(fullName);
+            }
+        }
+    }
+    return children;
+}
+/**
+ * Extract event references
+ *
+ * @ac US-017-AC-4: Extract event references
+ */
+function extractEvents(cmpXml) {
+    const events = [];
+    // Pattern: <aura:registerEvent name="myEvent" type="c:MyEvent"/>
+    const registerPattern = /<aura:registerEvent[^>]*type\s*=\s*["']([a-zA-Z][a-zA-Z0-9_:]*?)["']/g;
+    const registerMatches = cmpXml.matchAll(registerPattern);
+    for (const match of registerMatches) {
+        const eventType = match[1];
+        if (!events.includes(eventType)) {
+            events.push(eventType);
+        }
+    }
+    // Pattern: <aura:handler event="c:MyEvent" action="{!c.handleEvent}"/>
+    const handlerPattern = /<aura:handler[^>]*event\s*=\s*["']([a-zA-Z][a-zA-Z0-9_:]*?)["']/g;
+    const handlerMatches = cmpXml.matchAll(handlerPattern);
+    for (const match of handlerMatches) {
+        const eventType = match[1];
+        if (!events.includes(eventType)) {
+            events.push(eventType);
+        }
+    }
+    return events;
+}
+/**
+ * Determine component type from XML
+ */
+function getComponentType(cmpXml) {
+    if (cmpXml.includes('<aura:application')) {
+        return 'application';
+    }
+    if (cmpXml.includes('<aura:event')) {
+        return 'event';
+    }
+    if (cmpXml.includes('<aura:interface')) {
+        return 'interface';
+    }
+    return 'component';
+}
+/**
+ * Parse an Aura component and extract dependencies
+ *
+ * @param componentName - Name of the Aura component
+ * @param cmpContent - Content of the .cmp file
+ * @param hasController - Whether the component has a controller.js file
+ * @param hasHelper - Whether the component has a helper.js file
+ * @param hasStyle - Whether the component has a style.css file
+ * @returns AuraParseResult with all extracted dependencies
+ *
+ * @throws {ParsingError} If the component cannot be parsed
+ *
+ * @ac US-017-AC-6: Validate bundle structure
+ * @ac US-017-AC-7: Parse all bundle files (.cmp, .js, .css, etc.)
+ *
+ * @example
+ * ```typescript
+ * const result = parseAura('MyComponent', cmpContent, true, true, false);
+ * console.log(result.apexController); // 'MyController'
+ * console.log(result.childComponents); // ['c:ChildComponent']
+ * console.log(result.events); // ['c:MyEvent']
+ * ```
+ */
+export function parseAura(componentName, cmpContent, hasController = false, hasHelper = false, hasStyle = false) {
+    try {
+        logger.debug(`Parsing Aura component: ${componentName}`);
+        // Determine component type
+        const componentType = getComponentType(cmpContent);
+        // Extract dependencies
+        const apexController = extractApexController(cmpContent);
+        const extendsComponent = extractExtends(cmpContent);
+        const implementsInterfaces = extractImplements(cmpContent);
+        const childComponents = extractChildComponents(cmpContent);
+        const events = extractEvents(cmpContent);
+        // Build dependencies array
+        const dependencies = [];
+        if (apexController) {
+            dependencies.push({
+                type: 'apex_controller',
+                name: apexController,
+                namespace: apexController.includes('__') ? apexController.split('__')[0] : undefined,
+            });
+        }
+        if (extendsComponent) {
+            dependencies.push({
+                type: 'extends',
+                name: extendsComponent,
+                namespace: extendsComponent.includes(':') ? extendsComponent.split(':')[0] : undefined,
+            });
+        }
+        for (const iface of implementsInterfaces) {
+            dependencies.push({
+                type: 'interface',
+                name: iface,
+                namespace: iface.includes(':') ? iface.split(':')[0] : undefined,
+            });
+        }
+        for (const child of childComponents) {
+            dependencies.push({
+                type: 'child_component',
+                name: child,
+                namespace: child.includes(':') ? child.split(':')[0] : undefined,
+            });
+        }
+        for (const event of events) {
+            dependencies.push({
+                type: 'event',
+                name: event,
+                namespace: event.includes(':') ? event.split(':')[0] : undefined,
+            });
+        }
+        if (hasHelper) {
+            dependencies.push({
+                type: 'helper',
+                name: `${componentName}Helper`,
+            });
+        }
+        const result = {
+            componentName,
+            componentType,
+            apexController,
+            extendsComponent,
+            implementsInterfaces,
+            childComponents,
+            events,
+            dependencies,
+            hasController,
+            hasHelper,
+            hasStyle,
+        };
+        logger.debug(`Parsed Aura component: ${componentName}`, {
+            componentType,
+            apexController: !!apexController,
+            extendsComponent: !!extendsComponent,
+            implementsInterfaces: implementsInterfaces.length,
+            childComponents: childComponents.length,
+            events: events.length,
+            dependencies: dependencies.length,
+        });
+        return result;
+    }
+    catch (error) {
+        if (error instanceof ParsingError) {
+            throw error;
+        }
+        throw new ParsingError(`Failed to parse Aura component: ${componentName}`, {
+            filePath: componentName,
+            originalError: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+//# sourceMappingURL=aura-parser.js.map

package/lib/parsers/aura-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aura-parser.js","sourceRoot":"","sources":["../../src/parsers/aura-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG1D,MAAM,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC;AAmCvC;;;;GAIG;AACH,SAAS,qBAAqB,CAAC,MAAc;IAC3C,sEAAsE;IACtE,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;IAC3F,OAAO,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1D,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CAAC,MAAc;IACpC,0EAA0E;IAC1E,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrF,OAAO,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,SAAS,iBAAiB,CAAC,MAAc;IACvC,6EAA6E;IAC7E,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAC1E,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,eAAe,CAAC,CAAC,CAAC;SACtB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,SAAS,sBAAsB,CAAC,MAAc;IAC5C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,uEAAuE;IACvE,MAAM,gBAAgB,GAAG,2DAA2D,CAAC;IACrF,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAElD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAE/B,iDAAiD;QACjD,IAAI,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,WAAW,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YAC5E,MAAM,QAAQ,GAAG,GAAG,SAAS,IAAI,aAAa,EAAE,CAAC;YACjD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACjC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAED,iFAAiF;IACjF,MAAM,cAAc,GAAG,0DAA0D,CAAC;IAClF,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAEpD,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAE/B,IAAI,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,WAAW,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YAC5E,MAAM,QAAQ,GAAG,GAAG,SAAS,IAAI,aAAa,EAAE,CAAC;YACjD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACjC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,MAAc;IACnC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,iEAAiE;IACjE,MAAM,eAAe,GAAG,uEAAuE,CAAC;IAChG,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAEzD,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAChC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,MAAM,cAAc,GAAG,kEAAkE,CAAC;IAC1F,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAEvD,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAChC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,MAAc;IACtC,IAAI,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACzC,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QACnC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACvC,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,SAAS,CACvB,aAAqB,EACrB,UAAkB,EAClB,aAAa,GAAG,KAAK,EACrB,SAAS,GAAG,KAAK,EACjB,QAAQ,GAAG,KAAK;IAEhB,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,2BAA2B,aAAa,EAAE,CAAC,CAAC;QAEzD,2BAA2B;QAC3B,MAAM,aAAa,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAEnD,uBAAuB;QACvB,MAAM,cAAc,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;QACzD,MAAM,gBAAgB,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;QACpD,MAAM,oBAAoB,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAC3D,MAAM,eAAe,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;QAEzC,2BAA2B;QAC3B,MAAM,YAAY,GAAqB,EAAE,CAAC;QAE1C,IAAI,cAAc,EAAE,CAAC;YACnB,YAAY,CAAC,IAAI,CAAC;gBAChB,IAAI,EAAE,iBAAiB;gBACvB,IAAI,EAAE,cAAc;gBACpB,SAAS,EAAE,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;aACrF,CAAC,CAAC;QACL,CAAC;QAED,IAAI,gBAAgB,EAAE,CAAC;YACrB,YAAY,CAAC,IAAI,CAAC;gBAChB,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,gBAAgB;gBACtB,SAAS,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;aACvF,CAAC,CAAC;QACL,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,oBAAoB,EAAE,CAAC;YACzC,YAAY,CAAC,IAAI,CAAC;gBAChB,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,KAAK;gBACX,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;aACjE,CAAC,CAAC;QACL,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;YACpC,YAAY,CAAC,IAAI,CAAC;gBAChB,IAAI,EAAE,iBAAiB;gBACvB,IAAI,EAAE,KAAK;gBACX,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;aACjE,CAAC,CAAC;QACL,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,YAAY,CAAC,IAAI,CAAC;gBAChB,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,KAAK;gBACX,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;aACjE,CAAC,CAAC;QACL,CAAC;QAED,IAAI,SAAS,EAAE,CAAC;YACd,YAAY,CAAC,IAAI,CAAC;gBAChB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,GAAG,aAAa,QAAQ;aAC/B,CAAC,CAAC;QACL,CAAC;QAED,MAAM,MAAM,GAAoB;YAC9B,aAAa;YACb,aAAa;YACb,cAAc;YACd,gBAAgB;YAChB,oBAAoB;YACpB,eAAe;YACf,MAAM;YACN,YAAY;YACZ,aAAa;YACb,SAAS;YACT,QAAQ;SACT,CAAC;QAEF,MAAM,CAAC,KAAK,CAAC,0BAA0B,aAAa,EAAE,EAAE;YACtD,aAAa;YACb,cAAc,EAAE,CAAC,CAAC,cAAc;YAChC,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;YACpC,oBAAoB,EAAE,oBAAoB,CAAC,MAAM;YACjD,eAAe,EAAE,eAAe,CAAC,MAAM;YACvC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,YAAY,EAAE,YAAY,CAAC,MAAM;SAClC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;YAClC,MAAM,KAAK,CAAC;QACd,CAAC;QAED,MAAM,IAAI,YAAY,CAAC,mCAAmC,aAAa,EAAE,EAAE;YACzE,QAAQ,EAAE,aAAa;YACvB,aAAa,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SACtE,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/lib/parsers/bot-parser.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Bot Parser
+ * Parses Salesforce Einstein Bot metadata files (.bot-meta.xml)
+ *
+ * @ac US-024-AC-1: Extract dialog references
+ * @ac US-024-AC-2: Extract GenAI prompt references
+ * @ac US-024-AC-3: Extract Flow references
+ * @ac US-024-AC-4: Extract Apex action references
+ * @ac US-024-AC-5: Extract menu item references
+ * @ac US-024-AC-6: Link to all dependencies
+ *
+ * @issue #24
+ */
+/**
+ * Result of parsing a Bot file
+ */
+export type BotParseResult = {
+    /** Name of the bot (from filename) */
+    name: string;
+    /** Label */
+    label: string;
+    /** Description */
+    description?: string;
+    /** Dialog references */
+    dialogs: string[];
+    /** GenAI prompt references */
+    genAiPrompts: string[];
+    /** Flow references */
+    flows: string[];
+    /** Apex action references */
+    apexActions: string[];
+    /** Menu items (dialogs in footer menu) */
+    menuItems: string[];
+    /** ML Intents */
+    mlIntents: string[];
+    /** SObjects referenced */
+    sobjects: string[];
+    /** All dependencies extracted from this bot */
+    dependencies: {
+        dialogs: string[];
+        genAiPrompts: string[];
+        flows: string[];
+        apexActions: string[];
+        menuItems: string[];
+        mlIntents: string[];
+        sobjects: string[];
+    };
+};
+/**
+ * Parse a Bot metadata XML file
+ *
+ * @param filePath - Path to the .bot-meta.xml file
+ * @param botName - Name of the bot (typically from filename)
+ * @returns Parsed bot metadata with dependencies
+ *
+ * @example
+ * const result = await parseBot(
+ *   'force-app/main/default/bots/Support_Bot.bot-meta.xml',
+ *   'Support_Bot'
+ * );
+ * console.log(result.dialogs); // ['Greeting', 'CaseCreation', 'FAQ']
+ * console.log(result.flows); // ['Case_Assignment_Flow']
+ * console.log(result.genAiPrompts); // ['SummarizeCase']
+ */
+export declare function parseBot(filePath: string, botName: string): Promise<BotParseResult>;

package/lib/parsers/bot-parser.js

@@ -0,0 +1,225 @@
+/**
+ * Bot Parser
+ * Parses Salesforce Einstein Bot metadata files (.bot-meta.xml)
+ *
+ * @ac US-024-AC-1: Extract dialog references
+ * @ac US-024-AC-2: Extract GenAI prompt references
+ * @ac US-024-AC-3: Extract Flow references
+ * @ac US-024-AC-4: Extract Apex action references
+ * @ac US-024-AC-5: Extract menu item references
+ * @ac US-024-AC-6: Link to all dependencies
+ *
+ * @issue #24
+ */
+import { readFile } from 'node:fs/promises';
+import { XMLParser } from 'fast-xml-parser';
+/**
+ * Normalize value to array (handles XML parser returning single object vs array)
+ */
+function normalizeArray(value) {
+    if (!value)
+        return [];
+    return Array.isArray(value) ? value : [value];
+}
+/**
+ * Extract invocations from bot steps recursively
+ */
+function extractInvocationsFromSteps(steps) {
+    const flows = [];
+    const apexActions = [];
+    const genAiPrompts = [];
+    for (const step of steps) {
+        // Extract from botInvocation
+        if (step.botInvocation) {
+            const invocation = step.botInvocation;
+            if (invocation.invocationActionName) {
+                switch (invocation.invocationActionType) {
+                    case 'flow':
+                        flows.push(invocation.invocationActionName);
+                        break;
+                    case 'apex':
+                        apexActions.push(invocation.invocationActionName);
+                        break;
+                    case 'prompt':
+                        genAiPrompts.push(invocation.invocationActionName);
+                        break;
+                    case 'externalService':
+                    case 'standardInvocableAction':
+                    case undefined:
+                        // These types don't need specific tracking
+                        break;
+                }
+            }
+        }
+        // Extract from botVariableOperation.botInvocation
+        if (step.botVariableOperation?.botInvocation) {
+            const invocation = step.botVariableOperation.botInvocation;
+            if (invocation.invocationActionName) {
+                switch (invocation.invocationActionType) {
+                    case 'flow':
+                        flows.push(invocation.invocationActionName);
+                        break;
+                    case 'apex':
+                        apexActions.push(invocation.invocationActionName);
+                        break;
+                    case 'prompt':
+                        genAiPrompts.push(invocation.invocationActionName);
+                        break;
+                    case 'externalService':
+                    case 'standardInvocableAction':
+                    case undefined:
+                        // These types don't need specific tracking
+                        break;
+                }
+            }
+        }
+        // Recursively extract from nested steps
+        if (step.botSteps) {
+            const nested = extractInvocationsFromSteps(normalizeArray(step.botSteps));
+            flows.push(...nested.flows);
+            apexActions.push(...nested.apexActions);
+            genAiPrompts.push(...nested.genAiPrompts);
+        }
+    }
+    return { flows, apexActions, genAiPrompts };
+}
+/**
+ * Extract SObjects from conversation record lookups in bot steps
+ */
+function extractSObjectsFromSteps(steps) {
+    const sobjects = [];
+    for (const step of steps) {
+        // Extract from conversationRecordLookup
+        if (step.conversationRecordLookup) {
+            sobjects.push(step.conversationRecordLookup.SObjectType);
+        }
+        // Recursively extract from nested steps
+        if (step.botSteps) {
+            sobjects.push(...extractSObjectsFromSteps(normalizeArray(step.botSteps)));
+        }
+    }
+    return sobjects;
+}
+/**
+ * Extract all references from bot dialogs
+ */
+function extractReferencesFromDialogs(dialogs) {
+    const allFlows = [];
+    const allApexActions = [];
+    const allGenAiPrompts = [];
+    const allSObjects = [];
+    for (const dialog of dialogs) {
+        const steps = normalizeArray(dialog.botSteps);
+        // Extract invocations
+        const { flows, apexActions, genAiPrompts } = extractInvocationsFromSteps(steps);
+        allFlows.push(...flows);
+        allApexActions.push(...apexActions);
+        allGenAiPrompts.push(...genAiPrompts);
+        // Extract SObjects
+        const sobjects = extractSObjectsFromSteps(steps);
+        allSObjects.push(...sobjects);
+    }
+    return {
+        flows: [...new Set(allFlows)],
+        apexActions: [...new Set(allApexActions)],
+        genAiPrompts: [...new Set(allGenAiPrompts)],
+        sobjects: [...new Set(allSObjects)],
+    };
+}
+/**
+ * Parse a Bot metadata XML file
+ *
+ * @param filePath - Path to the .bot-meta.xml file
+ * @param botName - Name of the bot (typically from filename)
+ * @returns Parsed bot metadata with dependencies
+ *
+ * @example
+ * const result = await parseBot(
+ *   'force-app/main/default/bots/Support_Bot.bot-meta.xml',
+ *   'Support_Bot'
+ * );
+ * console.log(result.dialogs); // ['Greeting', 'CaseCreation', 'FAQ']
+ * console.log(result.flows); // ['Case_Assignment_Flow']
+ * console.log(result.genAiPrompts); // ['SummarizeCase']
+ */
+export async function parseBot(filePath, botName) {
+    // Read and parse XML
+    const xmlContent = await readFile(filePath, 'utf-8');
+    const parser = new XMLParser({
+        ignoreAttributes: false,
+        parseAttributeValue: true,
+        trimValues: true,
+    });
+    let parsed;
+    try {
+        parsed = parser.parse(xmlContent);
+    }
+    catch (error) {
+        throw new Error(`Failed to parse Bot XML at ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    // Type assertion with validation
+    const root = parsed;
+    if (!root.Bot) {
+        throw new Error(`Invalid Bot XML structure at ${filePath}: missing Bot root element`);
+    }
+    const metadata = root.Bot;
+    // Extract bot versions and dialogs
+    const botVersions = normalizeArray(metadata.botVersions);
+    const allDialogs = [];
+    for (const version of botVersions) {
+        const versionDialogs = normalizeArray(version.botDialogs);
+        allDialogs.push(...versionDialogs);
+    }
+    // Extract dialog names
+    const dialogNames = allDialogs.map((dialog) => dialog.developerName);
+    // Extract menu items (dialogs shown in footer menu)
+    const menuItems = allDialogs
+        .filter((dialog) => dialog.showInFooterMenu === true)
+        .map((dialog) => dialog.developerName);
+    // Extract ML Intents
+    const mlIntents = normalizeArray(metadata.mlIntents).map((intent) => intent.developerName);
+    // Extract invocations and SObjects from all dialogs
+    const { flows, apexActions, genAiPrompts, sobjects } = extractReferencesFromDialogs(allDialogs);
+    // Extract SObjects from conversation variables
+    const variableSObjects = [];
+    for (const version of botVersions) {
+        const variables = normalizeArray(version.conversationVariables);
+        for (const variable of variables) {
+            if (variable.SObjectType) {
+                variableSObjects.push(variable.SObjectType);
+            }
+        }
+    }
+    // Extract SObjects from context variables
+    const contextVariables = normalizeArray(metadata.contextVariables);
+    for (const variable of contextVariables) {
+        if (variable.SObjectType) {
+            variableSObjects.push(variable.SObjectType);
+        }
+    }
+    // Combine and deduplicate SObjects
+    const allSObjects = [...new Set([...sobjects, ...variableSObjects])];
+    // Build result
+    return {
+        name: botName,
+        label: metadata.label,
+        description: metadata.description,
+        dialogs: dialogNames,
+        genAiPrompts,
+        flows,
+        apexActions,
+        menuItems,
+        mlIntents,
+        sobjects: allSObjects,
+        dependencies: {
+            dialogs: dialogNames,
+            genAiPrompts,
+            flows,
+            apexActions,
+            menuItems,
+            mlIntents,
+            sobjects: allSObjects,
+        },
+    };
+}
+//# sourceMappingURL=bot-parser.js.map

package/lib/parsers/bot-parser.js.map

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