@jterrats/smart-deployment 1.0.3

package/lib/parsers/error-resilient-parser.js

@@ -0,0 +1,277 @@
+/**
+ * Error-Resilient Parser Wrapper - US-071
+ * Gracefully handles parse errors without breaking analysis
+ *
+ * @ac US-071-AC-1: Catch and log parse errors
+ * @ac US-071-AC-2: Continue with other files
+ * @ac US-071-AC-3: Report errors with file paths
+ * @ac US-071-AC-4: Suggest fixes when possible
+ * @ac US-071-AC-5: Aggregate error report
+ * @ac US-071-AC-6: Option to fail-fast
+ * @issue #71
+ */
+import { getLogger } from '../utils/logger.js';
+import { getErrorAggregator } from '../utils/error-aggregator.js';
+const logger = getLogger('ErrorResilientParser');
+const errorAggregator = getErrorAggregator();
+/**
+ * @ac US-071-AC-1: Catch and log parse errors
+ * @ac US-071-AC-2: Continue with other files
+ */
+export class ErrorResilientParser {
+    options;
+    errors = [];
+    constructor(options = {}) {
+        this.options = {
+            failFast: options.failFast ?? false,
+            logErrors: options.logErrors ?? true,
+            suggestFixes: options.suggestFixes ?? true,
+        };
+        logger.debug('Error-resilient parser initialized', { options: this.options });
+    }
+    /**
+     * @ac US-071-AC-1: Catch and log parse errors
+     * @ac US-071-AC-2: Continue with other files
+     * Parse multiple files with error resilience
+     */
+    async parseFiles(filePaths, parser) {
+        logger.info('Starting resilient parse', {
+            fileCount: filePaths.length,
+            failFast: this.options.failFast,
+        });
+        const results = this.options.failFast
+            ? await this.parseFilesSequentially(filePaths, parser)
+            : await Promise.all(filePaths.map(async (filePath) => this.parseFile(filePath, parser)));
+        logger.info('Resilient parse completed', {
+            totalFiles: filePaths.length,
+            successCount: results.filter((r) => r.success).length,
+            errorCount: results.filter((r) => !r.success).length,
+        });
+        return results;
+    }
+    async parseFilesSequentially(filePaths, parser, results = []) {
+        if (filePaths.length === 0) {
+            return results;
+        }
+        const [filePath, ...remaining] = filePaths;
+        const result = await this.parseFile(filePath, parser);
+        results.push(result);
+        if (!result.success) {
+            logger.warn('Fail-fast enabled, stopping parse', {
+                filePath,
+                totalProcessed: results.length,
+                totalFiles: results.length + remaining.length,
+            });
+            return results;
+        }
+        return this.parseFilesSequentially(remaining, parser, results);
+    }
+    /**
+     * @ac US-071-AC-1: Catch and log parse errors
+     * Parse single file with error handling
+     */
+    async parseFile(filePath, parser) {
+        try {
+            const data = await parser(filePath);
+            return {
+                success: true,
+                data,
+                filePath,
+            };
+        }
+        catch (error) {
+            const parseError = this.createParseError(filePath, error);
+            // Log to aggregator
+            if (this.options.logErrors) {
+                errorAggregator.addError({
+                    message: parseError.message,
+                    type: parseError.errorType,
+                    severity: 'MEDIUM',
+                    filePath: parseError.filePath,
+                    lineNumber: parseError.lineNumber,
+                    columnNumber: parseError.columnNumber,
+                    context: {
+                        suggestedFix: parseError.suggestedFix,
+                    },
+                });
+            }
+            // Track locally
+            this.errors.push(parseError);
+            logger.warn('Parse error caught', {
+                filePath,
+                errorType: parseError.errorType,
+                message: parseError.message,
+            });
+            return {
+                success: false,
+                error: parseError,
+                filePath,
+            };
+        }
+    }
+    /**
+     * @ac US-071-AC-3: Report errors with file paths
+     * @ac US-071-AC-4: Suggest fixes when possible
+     * Create structured parse error
+     */
+    createParseError(filePath, error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorStack = error instanceof Error ? error.stack : undefined;
+        // Extract line/column from error message if available
+        const locationMatch = /:(\d+):(\d+)/.exec(errorMessage);
+        const lineNumber = locationMatch ? Number.parseInt(locationMatch[1], 10) : undefined;
+        const columnNumber = locationMatch ? Number.parseInt(locationMatch[2], 10) : undefined;
+        // Determine error type
+        const errorType = this.categorizeError(errorMessage);
+        // Suggest fix if enabled
+        const suggestedFix = this.options.suggestFixes ? this.suggestFix(errorType, errorMessage) : undefined;
+        return {
+            filePath,
+            errorType,
+            message: errorMessage,
+            lineNumber,
+            columnNumber,
+            suggestedFix,
+            stack: errorStack,
+        };
+    }
+    /**
+     * Categorize error by type
+     */
+    categorizeError(message) {
+        const patterns = [
+            { pattern: /syntax error/i, type: 'SyntaxError' },
+            { pattern: /unexpected token/i, type: 'SyntaxError' },
+            { pattern: /missing/i, type: 'SyntaxError' },
+            { pattern: /expected/i, type: 'SyntaxError' },
+            { pattern: /cannot find/i, type: 'ReferenceError' },
+            { pattern: /not found/i, type: 'ReferenceError' },
+            { pattern: /ENOENT/i, type: 'FileNotFoundError' },
+            { pattern: /EACCES/i, type: 'PermissionError' },
+            { pattern: /encoding/i, type: 'EncodingError' },
+            { pattern: /xml/i, type: 'XMLParseError' },
+        ];
+        for (const { pattern, type } of patterns) {
+            if (pattern.test(message)) {
+                return type;
+            }
+        }
+        return 'ParseError';
+    }
+    /**
+     * @ac US-071-AC-4: Suggest fixes when possible
+     * Suggest fix based on error type
+     */
+    suggestFix(errorType, message) {
+        const suggestions = {
+            SyntaxError: 'Check for missing brackets, quotes, or semicolons. Validate XML/JSON structure.',
+            ReferenceError: 'Ensure the referenced component exists in the project or check dependencies.',
+            FileNotFoundError: 'Verify the file exists at the specified path. Check .forceignore rules.',
+            PermissionError: 'Check file permissions. Ensure read access to the file.',
+            EncodingError: 'Ensure file is encoded in UTF-8. Check for BOM or special characters.',
+            XMLParseError: 'Validate XML syntax. Check for unclosed tags or missing declarations.',
+        };
+        const baseSuggestion = suggestions[errorType];
+        // Add specific suggestions based on message
+        if (message.includes('Unexpected token')) {
+            return `${baseSuggestion || ''} Check for stray characters or incorrect syntax.`.trim();
+        }
+        if (message.includes('Expected')) {
+            return `${baseSuggestion || ''} Ensure all required elements are present.`.trim();
+        }
+        return baseSuggestion;
+    }
+    /**
+     * @ac US-071-AC-5: Aggregate error report
+     * Generate comprehensive error report
+     */
+    generateErrorReport() {
+        const lines = [];
+        lines.push('🔧 Parse Error Report');
+        lines.push('═══════════════════════════════════════');
+        if (this.errors.length === 0) {
+            lines.push('✅ No parse errors encountered');
+            return lines.join('\n');
+        }
+        lines.push(`❌ Total Errors: ${this.errors.length}`);
+        lines.push('');
+        // Group by error type
+        const byType = new Map();
+        for (const error of this.errors) {
+            const errors = byType.get(error.errorType) ?? [];
+            errors.push(error);
+            byType.set(error.errorType, errors);
+        }
+        lines.push('📊 Errors by Type:');
+        for (const [type, errors] of byType.entries()) {
+            lines.push(`   ${type}: ${errors.length}`);
+        }
+        lines.push('');
+        // List errors (limit to first 20)
+        lines.push('📋 Error Details:');
+        const errorsToShow = this.errors.slice(0, 20);
+        for (const [index, error] of errorsToShow.entries()) {
+            lines.push(`\n${index + 1}. ${error.errorType} in ${error.filePath}`);
+            lines.push(`   Message: ${error.message}`);
+            if (error.lineNumber) {
+                lines.push(`   Location: Line ${error.lineNumber}${error.columnNumber ? `:${error.columnNumber}` : ''}`);
+            }
+            if (error.suggestedFix) {
+                lines.push(`   💡 Suggestion: ${error.suggestedFix}`);
+            }
+        }
+        if (this.errors.length > 20) {
+            lines.push(`\n... and ${this.errors.length - 20} more errors`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Get all errors
+     */
+    getErrors() {
+        return [...this.errors];
+    }
+    /**
+     * Get error count
+     */
+    getErrorCount() {
+        return this.errors.length;
+    }
+    /**
+     * Check if any errors occurred
+     */
+    hasErrors() {
+        return this.errors.length > 0;
+    }
+    /**
+     * Clear errors
+     */
+    clearErrors() {
+        this.errors.length = 0;
+    }
+    /**
+     * Get successful parse count
+     */
+    static getSuccessCount(results) {
+        return results.filter((r) => r.success).length;
+    }
+    /**
+     * Get failed parse count
+     */
+    static getFailureCount(results) {
+        return results.filter((r) => !r.success).length;
+    }
+    /**
+     * Extract only successful results
+     */
+    static getSuccessfulData(results) {
+        return results.filter((r) => r.success && r.data !== undefined).map((r) => r.data);
+    }
+    /**
+     * Extract only errors
+     */
+    static getErrors(results) {
+        return results.filter((r) => !r.success && r.error !== undefined).map((r) => r.error);
+    }
+}
+//# sourceMappingURL=error-resilient-parser.js.map

package/lib/parsers/error-resilient-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-resilient-parser.js","sourceRoot":"","sources":["../../src/parsers/error-resilient-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE,MAAM,MAAM,GAAG,SAAS,CAAC,sBAAsB,CAAC,CAAC;AACjD,MAAM,eAAe,GAAG,kBAAkB,EAAE,CAAC;AA8B7C;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IACd,OAAO,CAAgB;IACvB,MAAM,GAAiB,EAAE,CAAC;IAE3C,YAAmB,UAAkC,EAAE;QACrD,IAAI,CAAC,OAAO,GAAG;YACb,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK;YACnC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;YACpC,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI;SAC3C,CAAC;QAEF,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,UAAU,CAAI,SAAmB,EAAE,MAAyB;QACvE,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE;YACtC,SAAS,EAAE,SAAS,CAAC,MAAM;YAC3B,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ;SAChC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ;YACnC,CAAC,CAAC,MAAM,IAAI,CAAC,sBAAsB,CAAC,SAAS,EAAE,MAAM,CAAC;YACtD,CAAC,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QAE3F,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE;YACvC,UAAU,EAAE,SAAS,CAAC,MAAM;YAC5B,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM;YACrD,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM;SACrD,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,KAAK,CAAC,sBAAsB,CAClC,SAAmB,EACnB,MAAyB,EACzB,UAAiC,EAAE;QAEnC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,MAAM,CAAC,QAAQ,EAAE,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;QAC3C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAErB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE;gBAC/C,QAAQ;gBACR,cAAc,EAAE,OAAO,CAAC,MAAM;gBAC9B,UAAU,EAAE,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM;aAC9C,CAAC,CAAC;YACH,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,OAAO,IAAI,CAAC,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,SAAS,CAAI,QAAgB,EAAE,MAAyB;QACnE,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;YAEpC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI;gBACJ,QAAQ;aACT,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAE1D,oBAAoB;YACpB,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;gBAC3B,eAAe,CAAC,QAAQ,CAAC;oBACvB,OAAO,EAAE,UAAU,CAAC,OAAO;oBAC3B,IAAI,EAAE,UAAU,CAAC,SAAS;oBAC1B,QAAQ,EAAE,QAAQ;oBAClB,QAAQ,EAAE,UAAU,CAAC,QAAQ;oBAC7B,UAAU,EAAE,UAAU,CAAC,UAAU;oBACjC,YAAY,EAAE,UAAU,CAAC,YAAY;oBACrC,OAAO,EAAE;wBACP,YAAY,EAAE,UAAU,CAAC,YAAY;qBACtC;iBACF,CAAC,CAAC;YACL,CAAC;YAED,gBAAgB;YAChB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAE7B,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE;gBAChC,QAAQ;gBACR,SAAS,EAAE,UAAU,CAAC,SAAS;gBAC/B,OAAO,EAAE,UAAU,CAAC,OAAO;aAC5B,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,UAAU;gBACjB,QAAQ;aACT,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,gBAAgB,CAAC,QAAgB,EAAE,KAAc;QACvD,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,MAAM,UAAU,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QAEpE,sDAAsD;QACtD,MAAM,aAAa,GAAG,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACxD,MAAM,UAAU,GAAG,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACrF,MAAM,YAAY,GAAG,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAEvF,uBAAuB;QACvB,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;QAErD,yBAAyB;QACzB,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAEtG,OAAO;YACL,QAAQ;YACR,SAAS;YACT,OAAO,EAAE,YAAY;YACrB,UAAU;YACV,YAAY;YACZ,YAAY;YACZ,KAAK,EAAE,UAAU;SAClB,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,OAAe;QACrC,MAAM,QAAQ,GAAG;YACf,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,aAAa,EAAE;YACjD,EAAE,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,aAAa,EAAE;YACrD,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE;YAC5C,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE;YAC7C,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,gBAAgB,EAAE;YACnD,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,gBAAgB,EAAE;YACjD,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,mBAAmB,EAAE;YACjD,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,iBAAiB,EAAE;YAC/C,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,EAAE;YAC/C,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE;SAC3C,CAAC;QAEF,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,QAAQ,EAAE,CAAC;YACzC,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1B,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAED;;;OAGG;IACK,UAAU,CAAC,SAAiB,EAAE,OAAe;QACnD,MAAM,WAAW,GAA2B;YAC1C,WAAW,EAAE,iFAAiF;YAC9F,cAAc,EAAE,8EAA8E;YAC9F,iBAAiB,EAAE,yEAAyE;YAC5F,eAAe,EAAE,yDAAyD;YAC1E,aAAa,EAAE,uEAAuE;YACtF,aAAa,EAAE,uEAAuE;SACvF,CAAC;QAEF,MAAM,cAAc,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;QAE9C,4CAA4C;QAC5C,IAAI,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACzC,OAAO,GAAG,cAAc,IAAI,EAAE,kDAAkD,CAAC,IAAI,EAAE,CAAC;QAC1F,CAAC;QAED,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACjC,OAAO,GAAG,cAAc,IAAI,EAAE,4CAA4C,CAAC,IAAI,EAAE,CAAC;QACpF,CAAC;QAED,OAAO,cAAc,CAAC;IACxB,CAAC;IAED;;;OAGG;IACI,mBAAmB;QACxB,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QAEtD,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;YAC5C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,mBAAmB,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,sBAAsB;QACtB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAC;QAC/C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YACjD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACjC,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9C,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7C,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,kCAAkC;QAClC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAChC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAE9C,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,GAAG,CAAC,KAAK,KAAK,CAAC,SAAS,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;YACtE,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAE3C,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACrB,KAAK,CAAC,IAAI,CAAC,qBAAqB,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3G,CAAC;YAED,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;gBACvB,KAAK,CAAC,IAAI,CAAC,qBAAqB,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE,cAAc,CAAC,CAAC;QACjE,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACI,SAAS;QACd,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACI,aAAa;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,SAAS;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACI,WAAW;QAChB,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IACzB,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,eAAe,CAAC,OAAoC;QAChE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACjD,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,eAAe,CAAC,OAAoC;QAChE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IAClD,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,iBAAiB,CAAI,OAA8B;QAC/D,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAK,CAAC,CAAC;IACtF,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,SAAS,CAAC,OAAoC;QAC1D,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAM,CAAC,CAAC;IACzF,CAAC;CACF"}

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

@@ -0,0 +1,64 @@
+/**
+ * FlexiPage Parser
+ * Parses Salesforce Lightning Page metadata files (.flexipage-meta.xml)
+ *
+ * @ac US-022-AC-1: Extract LWC component references
+ * @ac US-022-AC-2: Extract Aura component references
+ * @ac US-022-AC-3: Extract object references
+ * @ac US-022-AC-4: Extract record type filters
+ * @ac US-022-AC-5: Extract region configurations
+ * @ac US-022-AC-6: Link to all component dependencies
+ *
+ * @issue #22
+ */
+/**
+ * Result of parsing a FlexiPage file
+ */
+export type FlexiPageParseResult = {
+    /** Name of the FlexiPage (from filename) */
+    name: string;
+    /** Master label */
+    masterLabel: string;
+    /** FlexiPage type (AppPage, HomePage, RecordPage, etc.) */
+    type: string;
+    /** SObject type (for RecordPage) */
+    sobjectType?: string;
+    /** LWC components referenced */
+    lwcComponents: string[];
+    /** Aura components referenced */
+    auraComponents: string[];
+    /** Objects referenced */
+    objects: string[];
+    /** Record type filters */
+    recordTypeFilters: string[];
+    /** Region names configured */
+    regions: string[];
+    /** Quick actions */
+    quickActions: string[];
+    /** All dependencies extracted from this FlexiPage */
+    dependencies: {
+        lwcComponents: string[];
+        auraComponents: string[];
+        objects: string[];
+        recordTypes: string[];
+        regions: string[];
+        quickActions: string[];
+    };
+};
+/**
+ * Parse a FlexiPage metadata XML file
+ *
+ * @param filePath - Path to the .flexipage-meta.xml file
+ * @param flexiPageName - Name of the FlexiPage (typically from filename)
+ * @returns Parsed FlexiPage metadata with dependencies
+ *
+ * @example
+ * const result = await parseFlexiPage(
+ *   'force-app/main/default/flexipages/Account_Record_Page.flexipage-meta.xml',
+ *   'Account_Record_Page'
+ * );
+ * console.log(result.sobjectType); // 'Account'
+ * console.log(result.lwcComponents); // ['c:accountSummary', 'c:relatedContacts']
+ * console.log(result.dependencies.auraComponents); // ['c:AccountChart']
+ */
+export declare function parseFlexiPage(filePath: string, flexiPageName: string): Promise<FlexiPageParseResult>;

package/lib/parsers/flexipage-parser.js

@@ -0,0 +1,196 @@
+/**
+ * FlexiPage Parser
+ * Parses Salesforce Lightning Page metadata files (.flexipage-meta.xml)
+ *
+ * @ac US-022-AC-1: Extract LWC component references
+ * @ac US-022-AC-2: Extract Aura component references
+ * @ac US-022-AC-3: Extract object references
+ * @ac US-022-AC-4: Extract record type filters
+ * @ac US-022-AC-5: Extract region configurations
+ * @ac US-022-AC-6: Link to all component dependencies
+ *
+ * @issue #22
+ */
+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 components from item instances
+ */
+function extractComponentsFromItems(items) {
+    const lwcComponents = [];
+    const auraComponents = [];
+    const recordTypes = [];
+    for (const item of items) {
+        if (item.componentInstance) {
+            const componentName = item.componentInstance.componentName;
+            // LWC components use namespace:componentName or c:componentName format
+            // Aura components use namespace:componentName or c:componentName format
+            // Distinguish by convention: LWC typically lowercase, Aura camelCase
+            if (componentName.includes(':')) {
+                const [namespace, name] = componentName.split(':');
+                // Standard components (force:*, lightning:*, etc.)
+                if (namespace === 'force' || namespace === 'lightning' || namespace === 'forceChatter') {
+                    // Standard component, skip or log
+                }
+                else if (namespace === 'flexipage') {
+                    // Flexipage components, skip
+                }
+                else if (name && name.startsWith(name[0].toUpperCase())) {
+                    // Custom component - check naming convention
+                    // LWC: lowercase or camelCase starting with lowercase
+                    // Aura: PascalCase (starts with uppercase)
+                    auraComponents.push(componentName);
+                }
+                else {
+                    lwcComponents.push(componentName);
+                }
+            }
+            else if (componentName.startsWith(componentName[0].toUpperCase())) {
+                // No namespace - could be either, use naming convention
+                auraComponents.push(componentName);
+            }
+            else {
+                lwcComponents.push(componentName);
+            }
+            // Extract record type filters from visibility rules
+            if (item.componentInstance.visibilityRule) {
+                const criteria = normalizeArray(item.componentInstance.visibilityRule.criteria);
+                for (const criterion of criteria) {
+                    // Check if criterion references RecordType
+                    if (criterion.leftValue?.includes('RecordType') || criterion.rightValue?.includes('RecordType')) {
+                        const rtValue = criterion.rightValue ?? criterion.leftValue;
+                        if (rtValue && !rtValue.includes('RecordType')) {
+                            recordTypes.push(rtValue);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    return {
+        lwc: lwcComponents,
+        aura: auraComponents,
+        recordTypes,
+    };
+}
+/**
+ * Extract components from all regions
+ */
+function extractComponents(regions) {
+    const allLwc = [];
+    const allAura = [];
+    const allRecordTypes = [];
+    for (const region of regions) {
+        const items = normalizeArray(region.itemInstances);
+        const { lwc, aura, recordTypes } = extractComponentsFromItems(items);
+        allLwc.push(...lwc);
+        allAura.push(...aura);
+        allRecordTypes.push(...recordTypes);
+    }
+    return {
+        lwc: [...new Set(allLwc)],
+        aura: [...new Set(allAura)],
+        recordTypes: [...new Set(allRecordTypes)],
+    };
+}
+/**
+ * Extract quick actions from FlexiPage
+ */
+function extractQuickActions(metadata) {
+    const quickActions = [];
+    if (metadata.quickActionList?.quickActionListItems) {
+        const items = normalizeArray(metadata.quickActionList.quickActionListItems);
+        for (const item of items) {
+            quickActions.push(item.quickActionName);
+        }
+    }
+    if (metadata.platformActionList?.platformActionListItems) {
+        const items = normalizeArray(metadata.platformActionList.platformActionListItems);
+        for (const item of items) {
+            if (item.actionType === 'QuickAction') {
+                quickActions.push(item.actionName);
+            }
+        }
+    }
+    return [...new Set(quickActions)];
+}
+/**
+ * Parse a FlexiPage metadata XML file
+ *
+ * @param filePath - Path to the .flexipage-meta.xml file
+ * @param flexiPageName - Name of the FlexiPage (typically from filename)
+ * @returns Parsed FlexiPage metadata with dependencies
+ *
+ * @example
+ * const result = await parseFlexiPage(
+ *   'force-app/main/default/flexipages/Account_Record_Page.flexipage-meta.xml',
+ *   'Account_Record_Page'
+ * );
+ * console.log(result.sobjectType); // 'Account'
+ * console.log(result.lwcComponents); // ['c:accountSummary', 'c:relatedContacts']
+ * console.log(result.dependencies.auraComponents); // ['c:AccountChart']
+ */
+export async function parseFlexiPage(filePath, flexiPageName) {
+    // 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 FlexiPage XML at ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    // Type assertion with validation
+    const root = parsed;
+    if (!root.FlexiPage) {
+        throw new Error(`Invalid FlexiPage XML structure at ${filePath}: missing FlexiPage root element`);
+    }
+    const metadata = root.FlexiPage;
+    // Extract regions
+    const regions = normalizeArray(metadata.flexiPageRegions);
+    const regionNames = regions.map((region) => region.name);
+    // Extract components
+    const { lwc, aura, recordTypes } = extractComponents(regions);
+    // Extract objects
+    const objects = [];
+    if (metadata.sobjectType) {
+        objects.push(metadata.sobjectType);
+    }
+    // Extract quick actions
+    const quickActions = extractQuickActions(metadata);
+    // Build result
+    return {
+        name: flexiPageName,
+        masterLabel: metadata.masterLabel,
+        type: metadata.type,
+        sobjectType: metadata.sobjectType,
+        lwcComponents: lwc,
+        auraComponents: aura,
+        objects,
+        recordTypeFilters: recordTypes,
+        regions: regionNames,
+        quickActions,
+        dependencies: {
+            lwcComponents: lwc,
+            auraComponents: aura,
+            objects,
+            recordTypes,
+            regions: regionNames,
+            quickActions,
+        },
+    };
+}
+//# sourceMappingURL=flexipage-parser.js.map

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

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

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

@@ -0,0 +1,54 @@
+import type { FlowMetadata, FlowProcessType, FlowStatus } from '../types/salesforce/flow.js';
+/**
+ * Flow dependency types
+ */
+export type FlowDependencyType = 'apex_action' | 'subflow' | 'record' | 'genai_prompt' | 'screen_field' | 'decision';
+/**
+ * Re-export FlowProcessType and FlowStatus from Salesforce types
+ */
+export type { FlowProcessType, FlowStatus } from '../types/salesforce/flow.js';
+/**
+ * Represents a dependency found in a Flow
+ */
+export type FlowDependency = {
+    type: FlowDependencyType;
+    name: string;
+    reference?: string;
+};
+/**
+ * Result of parsing a Flow
+ * Optionally includes full metadata from Flow-meta.xml
+ */
+export type FlowParseResult = {
+    flowName: string;
+    flowType?: FlowProcessType;
+    status?: FlowStatus;
+    apexActions: string[];
+    subflows: string[];
+    recordReferences: string[];
+    genaiPrompts: string[];
+    dependencies: FlowDependency[];
+    metadata?: FlowMetadata;
+};
+/**
+ * Parse a Flow file and extract dependencies
+ *
+ * @param filePath - Path to the Flow file (.flow-meta.xml)
+ * @param content - Content of the Flow file
+ * @returns FlowParseResult with all extracted dependencies
+ *
+ * @throws {ParsingError} If the file cannot be parsed
+ *
+ * @ac US-015-AC-7: Handle all flow types (screen, record-triggered, scheduled)
+ * @ac US-015-AC-8: Parse flow metadata XML correctly
+ *
+ * @example
+ * ```typescript
+ * const result = parseFlow('MyFlow.flow-meta.xml', flowXmlContent);
+ * console.log(result.flowType); // 'Screen'
+ * console.log(result.apexActions); // ['MyApexClass.myMethod']
+ * console.log(result.subflows); // ['MySubflow']
+ * console.log(result.recordReferences); // ['Account', 'Contact']
+ * ```
+ */
+export declare function parseFlow(filePath: string, content: string): FlowParseResult;