@jterrats/smart-deployment 1.0.3

package/lib/parsers/layout-parser.js

@@ -0,0 +1,267 @@
+/**
+ * Layout Parser
+ * Parses Salesforce Page Layout metadata files (.layout-meta.xml)
+ *
+ * @ac AC-1: Extract related object (from filename)
+ * @ac AC-2: Extract custom button references
+ * @ac AC-3: Extract Visualforce page references
+ * @ac AC-4: Extract field references
+ * @ac AC-5: Extract related list references
+ * @ac AC-6: Link to dependent metadata
+ *
+ * @issue #21
+ */
+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 object name from layout filename
+ * Examples:
+ * 'Account-Account Layout' -> 'Account'
+ * 'CustomObject__c-Custom Layout' -> 'CustomObject__c'
+ */
+function extractObjectFromLayoutName(layoutName) {
+    const parts = layoutName.split('-');
+    return parts[0] || layoutName;
+}
+/**
+ * Extract custom buttons from layout and related lists
+ */
+function extractCustomButtons(metadata) {
+    const layoutCustomButtons = normalizeArray(metadata.customButtons);
+    const relatedListCustomButtons = [];
+    const relatedLists = normalizeArray(metadata.relatedLists);
+    for (const relatedList of relatedLists) {
+        const buttons = normalizeArray(relatedList.customButtons);
+        relatedListCustomButtons.push(...buttons);
+    }
+    return [...new Set([...layoutCustomButtons, ...relatedListCustomButtons])];
+}
+/**
+ * Extract Visualforce pages from layout sections
+ */
+function extractVFPagesFromSections(sections) {
+    const pages = [];
+    for (const section of sections) {
+        const columns = normalizeArray(section.layoutColumns);
+        for (const column of columns) {
+            const items = normalizeArray(column.layoutItems);
+            for (const item of items) {
+                if (item.page) {
+                    pages.push(item.page);
+                }
+            }
+        }
+    }
+    return pages;
+}
+/**
+ * Extract Visualforce pages from feed layout
+ */
+function extractVFPagesFromFeedLayout(feedLayout) {
+    if (!feedLayout)
+        return [];
+    const pages = [];
+    const leftComponents = normalizeArray(feedLayout.leftComponents);
+    const rightComponents = normalizeArray(feedLayout.rightComponents);
+    for (const component of [...leftComponents, ...rightComponents]) {
+        if (component.componentType === 'Visualforce' && component.page) {
+            pages.push(component.page);
+        }
+    }
+    return pages;
+}
+/**
+ * Extract fields from layout sections
+ */
+function extractFieldsFromSections(sections) {
+    const fields = [];
+    for (const section of sections) {
+        const columns = normalizeArray(section.layoutColumns);
+        for (const column of columns) {
+            const items = normalizeArray(column.layoutItems);
+            for (const item of items) {
+                if (item.field) {
+                    fields.push(item.field);
+                }
+            }
+        }
+    }
+    return fields;
+}
+/**
+ * Extract fields from various layout components
+ */
+function extractFields(metadata, layoutSections) {
+    const fields = [];
+    // From sections
+    fields.push(...extractFieldsFromSections(layoutSections));
+    // From related lists
+    const relatedLists = normalizeArray(metadata.relatedLists);
+    for (const relatedList of relatedLists) {
+        const listFields = normalizeArray(relatedList.fields);
+        fields.push(...listFields);
+    }
+    // From mini layout
+    if (metadata.miniLayout) {
+        const miniFields = normalizeArray(metadata.miniLayout.fields);
+        fields.push(...miniFields);
+    }
+    // From summary layout
+    if (metadata.summaryLayout) {
+        const summaryItems = normalizeArray(metadata.summaryLayout.summaryLayoutItems);
+        for (const item of summaryItems) {
+            if (item.field) {
+                fields.push(item.field);
+            }
+        }
+    }
+    return [...new Set(fields)];
+}
+/**
+ * Extract quick actions from layout
+ */
+function extractQuickActions(metadata) {
+    const quickActions = [];
+    if (metadata.quickActionList) {
+        const quickActionItems = normalizeArray(metadata.quickActionList.quickActionListItems);
+        quickActions.push(...quickActionItems.map((item) => item.quickActionName));
+    }
+    if (metadata.platformActionList) {
+        const actionItems = normalizeArray(metadata.platformActionList.platformActionListItems);
+        for (const item of actionItems) {
+            if (item.actionType === 'QuickAction') {
+                quickActions.push(item.actionName);
+            }
+        }
+    }
+    return [...new Set(quickActions)];
+}
+/**
+ * Extract canvas apps from layout sections
+ */
+function extractCanvasApps(sections) {
+    const apps = [];
+    for (const section of sections) {
+        const columns = normalizeArray(section.layoutColumns);
+        for (const column of columns) {
+            const items = normalizeArray(column.layoutItems);
+            for (const item of items) {
+                if (item.canvas) {
+                    apps.push(item.canvas);
+                }
+            }
+        }
+    }
+    return [...new Set(apps)];
+}
+/**
+ * Extract custom links from layout
+ */
+function extractCustomLinks(metadata, layoutSections) {
+    const links = [];
+    // From layout sections
+    for (const section of layoutSections) {
+        const columns = normalizeArray(section.layoutColumns);
+        for (const column of columns) {
+            const items = normalizeArray(column.layoutItems);
+            for (const item of items) {
+                if (item.customLink) {
+                    links.push(item.customLink);
+                }
+            }
+        }
+    }
+    // From summary layout
+    if (metadata.summaryLayout) {
+        const summaryItems = normalizeArray(metadata.summaryLayout.summaryLayoutItems);
+        for (const item of summaryItems) {
+            if (item.customLink) {
+                links.push(item.customLink);
+            }
+        }
+    }
+    return [...new Set(links)];
+}
+/**
+ * Parse a Layout metadata XML file
+ *
+ * @param filePath - Path to the .layout-meta.xml file
+ * @param layoutName - Name of the layout (typically from filename without extension)
+ * @returns Parsed layout metadata with dependencies
+ *
+ * @example
+ * const result = await parseLayout(
+ *   'force-app/main/default/layouts/Account-Account Layout.layout-meta.xml',
+ *   'Account-Account Layout'
+ * );
+ * console.log(result.object); // 'Account'
+ * console.log(result.customButtons); // ['New_Custom_Button', 'Edit_Button']
+ * console.log(result.dependencies.visualforcePages); // ['AccountDashboard']
+ */
+export async function parseLayout(filePath, layoutName) {
+    // 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 Layout XML at ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    // Type assertion with validation
+    const root = parsed;
+    if (!root.Layout) {
+        throw new Error(`Invalid Layout XML structure at ${filePath}: missing Layout root element`);
+    }
+    const metadata = root.Layout;
+    // Extract object name from layout name
+    const objectName = extractObjectFromLayoutName(layoutName);
+    // Extract dependencies using helper functions
+    const layoutSections = normalizeArray(metadata.layoutSections);
+    const relatedLists = normalizeArray(metadata.relatedLists);
+    const customButtons = extractCustomButtons(metadata);
+    const vfPagesFromSections = extractVFPagesFromSections(layoutSections);
+    const vfPagesFromFeed = extractVFPagesFromFeedLayout(metadata.feedLayout);
+    const visualforcePages = [...new Set([...vfPagesFromSections, ...vfPagesFromFeed])];
+    const fields = extractFields(metadata, layoutSections);
+    const relatedListNames = relatedLists.map((list) => list.relatedList);
+    const quickActions = extractQuickActions(metadata);
+    const canvasApps = extractCanvasApps(layoutSections);
+    const customLinks = extractCustomLinks(metadata, layoutSections);
+    // Build result
+    return {
+        name: layoutName,
+        object: objectName,
+        customButtons,
+        visualforcePages,
+        fields,
+        relatedLists: [...new Set(relatedListNames)],
+        quickActions,
+        canvasApps,
+        customLinks,
+        dependencies: {
+            object: objectName,
+            customButtons,
+            visualforcePages,
+            fields,
+            relatedLists: [...new Set(relatedListNames)],
+            quickActions,
+            canvasApps,
+            customLinks,
+        },
+    };
+}
+//# sourceMappingURL=layout-parser.js.map

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

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

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

@@ -0,0 +1,60 @@
+import type { LWCMetadata } from '../types/salesforce/lwc.js';
+/**
+ * LWC dependency types
+ */
+export type LWCDependencyType = 'apex_import' | 'lwc_import' | 'wire_adapter' | 'api_property' | 'navigation';
+/**
+ * Represents a dependency found in an LWC
+ */
+export type LWCDependency = {
+    type: LWCDependencyType;
+    name: string;
+    source?: string;
+    isTypeScript?: boolean;
+};
+/**
+ * Result of parsing an LWC
+ * Includes metadata from js-meta.xml
+ */
+export type LWCParseResult = {
+    componentName: string;
+    isTypeScript: boolean;
+    apexImports: string[];
+    lwcImports: string[];
+    wireAdapters: string[];
+    apiProperties: string[];
+    navigationRefs: string[];
+    dependencies: LWCDependency[];
+    hasMetadataXml: boolean;
+    metadata?: LWCMetadata;
+};
+/**
+ * Parse LWC js-meta.xml file
+ *
+ * @ac US-016-AC-8: Parse js-meta.xml correctly
+ * @deprecated - Will be refactored to return LWCMetadata type
+ *
+ * TODO: Refactor this function to properly parse and return LWCMetadata type
+ * Currently commented out to avoid unused variable warnings during refactoring
+ */
+/**
+ * Parse a Lightning Web Component and extract dependencies
+ *
+ * @param componentName - Name of the LWC component
+ * @param jsCode - JavaScript/TypeScript code of the component
+ * @param metadataXml - Optional js-meta.xml content
+ * @returns LWCParseResult with all extracted dependencies
+ *
+ * @throws {ParsingError} If the component cannot be parsed
+ *
+ * @ac US-016-AC-7: Validate bundle structure (js, html, xml)
+ *
+ * @example
+ * ```typescript
+ * const result = parseLWC('myComponent', jsCode, metadataXml);
+ * console.log(result.apexImports); // ['AccountController.getAccounts']
+ * console.log(result.lwcImports); // ['baseComponent', 'utilComponent']
+ * console.log(result.wireAdapters); // ['getRecord', 'getObjectInfo']
+ * ```
+ */
+export declare function parseLWC(componentName: string, jsCode: string, metadataXml?: string): LWCParseResult;

package/lib/parsers/lwc-parser.js

@@ -0,0 +1,264 @@
+import { getLogger } from '../utils/logger.js';
+import { ParsingError } from '../errors/parsing-error.js';
+const logger = getLogger('LWCParser');
+/**
+ * Remove comments from JavaScript/TypeScript code
+ */
+function removeComments(code) {
+    // Remove single-line comments (//)
+    let cleaned = code.replace(/\/\/.*$/gm, '');
+    // Remove multi-line comments (/* ... */)
+    cleaned = cleaned.replace(/\/\*[\s\S]*?\*\//g, '');
+    return cleaned;
+}
+/**
+ * Extract Apex imports
+ *
+ * @ac US-016-AC-1: Extract Apex imports (@salesforce/apex)
+ */
+function extractApexImports(code) {
+    // Pattern: import methodName from '@salesforce/apex/ClassName.methodName'
+    const apexImportPattern = /import\s+(?:\{[^}]+\}|\w+)\s+from\s+['"]@salesforce\/apex\/([a-zA-Z][a-zA-Z0-9_.]+)['"]/g;
+    const matches = code.matchAll(apexImportPattern);
+    const imports = [];
+    for (const match of matches) {
+        const apexRef = match[1]; // ClassName.methodName or ClassName
+        if (!imports.includes(apexRef)) {
+            imports.push(apexRef);
+        }
+    }
+    return imports;
+}
+/**
+ * Extract LWC imports
+ *
+ * @ac US-016-AC-2: Extract LWC imports (c/componentName)
+ */
+function extractLWCImports(code) {
+    // Pattern: import ComponentName from 'c/componentName'
+    const lwcImportPattern = /import\s+(?:\{[^}]+\}|\w+)\s+from\s+['"]c\/([a-zA-Z][a-zA-Z0-9_]+)['"]/g;
+    const matches = code.matchAll(lwcImportPattern);
+    const imports = [];
+    for (const match of matches) {
+        const componentName = match[1];
+        if (!imports.includes(componentName)) {
+            imports.push(componentName);
+        }
+    }
+    return imports;
+}
+/**
+ * Extract wire adapter usage
+ *
+ * @ac US-016-AC-3: Extract wire adapter usage
+ */
+function extractWireAdapters(code) {
+    // Pattern: @wire(adapterName, { ... })
+    const wirePattern = /@wire\s*\(\s*([a-zA-Z][a-zA-Z0-9_]*)/g;
+    const matches = code.matchAll(wirePattern);
+    const adapters = [];
+    for (const match of matches) {
+        const adapterName = match[1];
+        if (!adapters.includes(adapterName)) {
+            adapters.push(adapterName);
+        }
+    }
+    return adapters;
+}
+/**
+ * Extract @api property dependencies
+ *
+ * @ac US-016-AC-4: Extract @api property dependencies
+ */
+function extractApiProperties(code) {
+    // Pattern: @api propertyName
+    const apiPattern = /@api\s+([a-zA-Z][a-zA-Z0-9_]*)/g;
+    const matches = code.matchAll(apiPattern);
+    const properties = [];
+    for (const match of matches) {
+        const propertyName = match[1];
+        if (!properties.includes(propertyName)) {
+            properties.push(propertyName);
+        }
+    }
+    return properties;
+}
+/**
+ * Extract navigation references
+ *
+ * @ac US-016-AC-5: Extract navigation references
+ */
+function extractNavigationRefs(code) {
+    const refs = [];
+    // Pattern: NavigationMixin
+    if (code.includes('NavigationMixin')) {
+        refs.push('NavigationMixin');
+    }
+    // Pattern: this[NavigationMixin.Navigate]
+    if (code.includes('NavigationMixin.Navigate')) {
+        refs.push('NavigationMixin.Navigate');
+    }
+    // Pattern: import { NavigationMixin } from 'lightning/navigation'
+    const navImportPattern = /import\s+\{[^}]*NavigationMixin[^}]*\}\s+from\s+['"]lightning\/navigation['"]/;
+    if (navImportPattern.test(code)) {
+        refs.push('lightning/navigation');
+    }
+    return refs;
+}
+/**
+ * Detect if the component is TypeScript
+ *
+ * @ac US-016-AC-6: Handle TypeScript components
+ */
+function isTypeScriptComponent(jsCode) {
+    // Check for TypeScript-specific syntax
+    const tsPatterns = [
+        /:\s*(?:string|number|boolean|any|void|unknown|never)\s*[=;,)]/,
+        /interface\s+[A-Z][a-zA-Z0-9_]*\s*\{/,
+        /type\s+[A-Z][a-zA-Z0-9_]*\s*=/,
+        /<[A-Z][a-zA-Z0-9_<>,\s]*>/,
+        /as\s+(?:string|number|boolean|const)/,
+    ];
+    return tsPatterns.some((pattern) => pattern.test(jsCode));
+}
+/**
+ * Parse LWC js-meta.xml file
+ *
+ * @ac US-016-AC-8: Parse js-meta.xml correctly
+ * @deprecated - Will be refactored to return LWCMetadata type
+ *
+ * TODO: Refactor this function to properly parse and return LWCMetadata type
+ * Currently commented out to avoid unused variable warnings during refactoring
+ */
+/*
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+function parseMetadataXml(metadataContent: string): { exposedAs?: string } {
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unnecessary-type-assertion
+    const parsed = parseXml(metadataContent) as any;
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-assignment
+    const metadata = parsed.LightningComponentBundle;
+
+    if (!metadata) {
+      return {};
+    }
+
+    // Extract targets (where the component is exposed)
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-assignment
+    const targets = metadata.targets;
+    if (targets) {
+      // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-call
+      const targetList = Array.isArray(targets.target) ? targets.target : targets.target ? [targets.target] : [];
+      // Targets are extracted but we don't use exposedAs anymore
+      // Metadata will be parsed separately
+    }
+
+    return {};
+  } catch {
+    return {};
+  }
+}
+*/
+/**
+ * Parse a Lightning Web Component and extract dependencies
+ *
+ * @param componentName - Name of the LWC component
+ * @param jsCode - JavaScript/TypeScript code of the component
+ * @param metadataXml - Optional js-meta.xml content
+ * @returns LWCParseResult with all extracted dependencies
+ *
+ * @throws {ParsingError} If the component cannot be parsed
+ *
+ * @ac US-016-AC-7: Validate bundle structure (js, html, xml)
+ *
+ * @example
+ * ```typescript
+ * const result = parseLWC('myComponent', jsCode, metadataXml);
+ * console.log(result.apexImports); // ['AccountController.getAccounts']
+ * console.log(result.lwcImports); // ['baseComponent', 'utilComponent']
+ * console.log(result.wireAdapters); // ['getRecord', 'getObjectInfo']
+ * ```
+ */
+export function parseLWC(componentName, jsCode, metadataXml) {
+    try {
+        logger.debug(`Parsing LWC: ${componentName}`);
+        // Remove comments
+        const cleanCode = removeComments(jsCode);
+        // Detect TypeScript
+        const isTS = isTypeScriptComponent(cleanCode);
+        // Extract dependencies
+        const apexImports = extractApexImports(cleanCode);
+        const lwcImports = extractLWCImports(cleanCode);
+        const wireAdapters = extractWireAdapters(cleanCode);
+        const apiProperties = extractApiProperties(cleanCode);
+        const navigationRefs = extractNavigationRefs(cleanCode);
+        // Parse metadata XML if provided
+        let metadata;
+        let hasMetadataXml = false;
+        if (metadataXml) {
+            hasMetadataXml = true;
+            // Parse the metadata but we don't have a parseMetadataXml that returns LWCMetadata yet
+            // For now, we'll skip this part
+        }
+        // Build dependencies array
+        const dependencies = [
+            ...apexImports.map((name) => ({
+                type: 'apex_import',
+                name,
+                source: '@salesforce/apex',
+                isTypeScript: isTS,
+            })),
+            ...lwcImports.map((name) => ({
+                type: 'lwc_import',
+                name,
+                source: 'c',
+                isTypeScript: isTS,
+            })),
+            ...wireAdapters.map((name) => ({
+                type: 'wire_adapter',
+                name,
+                isTypeScript: isTS,
+            })),
+            ...apiProperties.map((name) => ({
+                type: 'api_property',
+                name,
+                isTypeScript: isTS,
+            })),
+            ...navigationRefs.map((name) => ({
+                type: 'navigation',
+                name,
+                isTypeScript: isTS,
+            })),
+        ];
+        const result = {
+            componentName,
+            isTypeScript: isTS,
+            apexImports,
+            lwcImports,
+            wireAdapters,
+            apiProperties,
+            navigationRefs,
+            dependencies,
+            hasMetadataXml,
+            metadata,
+        };
+        logger.debug(`Parsed LWC: ${componentName}`, {
+            isTypeScript: isTS,
+            apexImports: apexImports.length,
+            lwcImports: lwcImports.length,
+            wireAdapters: wireAdapters.length,
+            dependencies: dependencies.length,
+        });
+        return result;
+    }
+    catch (error) {
+        if (error instanceof ParsingError) {
+            throw error;
+        }
+        throw new ParsingError(`Failed to parse LWC: ${componentName}`, {
+            filePath: componentName,
+            originalError: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+//# sourceMappingURL=lwc-parser.js.map

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

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