@jterrats/smart-deployment 1.0.3

package/lib/parsers/email-template-parser.d.ts

@@ -0,0 +1,64 @@
+import type { EmailTemplateMetadata } from '../types/salesforce/email.js';
+/**
+ * Email template dependency types
+ */
+export type EmailTemplateDependencyType = 'merge_field' | 'visualforce_page' | 'related_entity' | 'attachment' | 'custom_label';
+/**
+ * Represents a dependency found in an email template
+ */
+export type EmailTemplateDependency = {
+    type: EmailTemplateDependencyType;
+    name: string;
+    objectName?: string;
+    fieldName?: string;
+};
+/**
+ * Merge field reference
+ */
+export type MergeField = {
+    fullReference: string;
+    objectName: string;
+    fieldName: string;
+    isRelated: boolean;
+    relationshipPath?: string;
+};
+/**
+ * Result of parsing an email template
+ * Extends EmailTemplateMetadata with parsed dependencies
+ * Overrides attachments to be string[] for easier consumption
+ */
+export type EmailTemplateParseResult = Omit<EmailTemplateMetadata, 'attachments'> & {
+    mergeFields: MergeField[];
+    customLabels: string[];
+    dependencies: EmailTemplateDependency[];
+    visualforcePage?: string;
+    attachments?: string[];
+};
+/**
+ * Parse an email template and extract dependencies
+ *
+ * @param templateName - Name of the email template
+ * @param templateContent - Content of the template (HTML, text, or VF)
+ * @param metadataContent - Content of the .email-meta.xml file
+ * @returns EmailTemplateParseResult with all extracted dependencies
+ *
+ * @throws {ParsingError} If the template cannot be parsed
+ *
+ * @ac US-019-AC-2: Extract Visualforce page references
+ * @ac US-019-AC-3: Extract relatedEntityType (target SObject)
+ * @ac US-019-AC-4: Extract attachment references
+ * @ac US-019-AC-7: Support all template types (text, html, visualforce, custom)
+ * @ac US-019-AC-8: Handle both body and subject merge fields
+ *
+ * @example
+ * ```typescript
+ * const result = await parseEmailTemplate(
+ *   'WelcomeEmail',
+ *   templateContent,
+ *   metadataXml
+ * );
+ * console.log(result.mergeFields); // [{objectName: 'Contact', fieldName: 'Name', ...}]
+ * console.log(result.relatedEntityType); // 'Contact'
+ * ```
+ */
+export declare function parseEmailTemplate(templateName: string, templateContent: string, metadataContent: string): Promise<EmailTemplateParseResult>;

package/lib/parsers/email-template-parser.js

@@ -0,0 +1,238 @@
+import { getLogger } from '../utils/logger.js';
+import { ParsingError } from '../errors/parsing-error.js';
+import { parseXml } from '../utils/xml.js';
+const logger = getLogger('EmailTemplateParser');
+/**
+ * Extract merge fields from template content
+ *
+ * @ac US-019-AC-1: Extract merge fields (object.field references)
+ */
+function extractMergeFields(content) {
+    const mergeFields = [];
+    const seen = new Set();
+    // Pattern: {!ObjectName.FieldName} or {!RelatedObject__r.Field__c}
+    // Also matches: {!Account.Owner.Name} (related traversal)
+    const mergeFieldPattern = /\{!([a-zA-Z][a-zA-Z0-9_]*(?:__[rc])?)\.([a-zA-Z][a-zA-Z0-9_.]*)\}/g;
+    const matches = content.matchAll(mergeFieldPattern);
+    for (const match of matches) {
+        const fullReference = match[0];
+        const objectName = match[1];
+        const fieldPath = match[2];
+        // Check if it's a related object traversal (contains dots)
+        const isRelated = fieldPath.includes('.');
+        const parts = fieldPath.split('.');
+        const fieldName = parts[parts.length - 1];
+        const relationshipPath = isRelated ? fieldPath : undefined;
+        const key = `${objectName}.${fieldPath}`;
+        if (!seen.has(key)) {
+            seen.add(key);
+            mergeFields.push({
+                fullReference,
+                objectName,
+                fieldName,
+                isRelated,
+                relationshipPath,
+            });
+        }
+    }
+    return mergeFields;
+}
+/**
+ * Extract custom label references
+ *
+ * @ac US-019-AC-5: Extract custom label references
+ */
+function extractCustomLabels(content) {
+    const labels = [];
+    const seen = new Set();
+    // Pattern: {!$Label.MyLabel} or {!$Label.namespace__MyLabel}
+    const labelPattern = /\{!\$Label\.([a-zA-Z][a-zA-Z0-9_.]*)\}/g;
+    const matches = content.matchAll(labelPattern);
+    for (const match of matches) {
+        const labelName = match[1];
+        if (!seen.has(labelName)) {
+            seen.add(labelName);
+            labels.push(labelName);
+        }
+    }
+    return labels;
+}
+/**
+ * Parse email template metadata XML
+ *
+ * @ac US-019-AC-6: Parse template metadata (.email-meta.xml)
+ */
+async function parseMetadataXml(metadataContent) {
+    try {
+        const parsed = await parseXml(metadataContent);
+        const parsedObj = parsed;
+        const emailTemplate = parsedObj.EmailTemplate || parsedObj;
+        // Normalize arrays (XML parser returns single items as objects, not arrays)
+        const normalizeArray = (value) => {
+            if (value === undefined)
+                return undefined;
+            return Array.isArray(value) ? value : [value];
+        };
+        // Normalize attachments (XML can have just <name> or full <content><name> structure)
+        let attachments = normalizeArray(emailTemplate.attachments);
+        if (attachments) {
+            attachments = attachments.map((att) => {
+                // If attachment is a string, it's just the name
+                if (typeof att === 'string') {
+                    return { name: att, content: '' };
+                }
+                // If it has a 'name' key with no content, set content to empty
+                if (typeof att === 'object' && att.name && !att.content) {
+                    return { name: String(att.name), content: '' };
+                }
+                return att;
+            });
+        }
+        // Map to EmailTemplateMetadata
+        const metadata = {
+            apiVersion: emailTemplate.apiVersion,
+            available: emailTemplate.available ?? false,
+            description: emailTemplate.description,
+            encodingKey: (emailTemplate.encodingKey ?? 'UTF-8'),
+            name: emailTemplate.name ?? '',
+            style: (emailTemplate.style ?? 'none'),
+            subject: emailTemplate.subject,
+            textOnly: emailTemplate.textOnly,
+            type: (emailTemplate.type ?? 'text'),
+            uiType: emailTemplate.uiType,
+            attachedContentDocuments: normalizeArray(emailTemplate.attachedContentDocuments),
+            attachments,
+            letterhead: emailTemplate.letterhead,
+            packageVersions: emailTemplate.packageVersions,
+            relatedEntityType: emailTemplate.relatedEntityType,
+            visualforcePage: emailTemplate.visualforcePage,
+        };
+        return metadata;
+    }
+    catch (error) {
+        throw new ParsingError('Failed to parse email template metadata XML', {
+            originalError: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+/**
+ * Parse an email template and extract dependencies
+ *
+ * @param templateName - Name of the email template
+ * @param templateContent - Content of the template (HTML, text, or VF)
+ * @param metadataContent - Content of the .email-meta.xml file
+ * @returns EmailTemplateParseResult with all extracted dependencies
+ *
+ * @throws {ParsingError} If the template cannot be parsed
+ *
+ * @ac US-019-AC-2: Extract Visualforce page references
+ * @ac US-019-AC-3: Extract relatedEntityType (target SObject)
+ * @ac US-019-AC-4: Extract attachment references
+ * @ac US-019-AC-7: Support all template types (text, html, visualforce, custom)
+ * @ac US-019-AC-8: Handle both body and subject merge fields
+ *
+ * @example
+ * ```typescript
+ * const result = await parseEmailTemplate(
+ *   'WelcomeEmail',
+ *   templateContent,
+ *   metadataXml
+ * );
+ * console.log(result.mergeFields); // [{objectName: 'Contact', fieldName: 'Name', ...}]
+ * console.log(result.relatedEntityType); // 'Contact'
+ * ```
+ */
+export async function parseEmailTemplate(templateName, templateContent, metadataContent) {
+    try {
+        logger.debug(`Parsing email template: ${templateName}`);
+        // Parse metadata XML using Salesforce types
+        const metadata = await parseMetadataXml(metadataContent);
+        // Extract merge fields from content and subject
+        const contentMergeFields = extractMergeFields(templateContent);
+        const subjectMergeFields = metadata.subject ? extractMergeFields(metadata.subject) : [];
+        const mergeFields = [...contentMergeFields, ...subjectMergeFields];
+        // Extract custom labels
+        const customLabels = extractCustomLabels(templateContent);
+        // Build dependencies array
+        const dependencies = [];
+        // Add related entity type as dependency
+        if (metadata.relatedEntityType) {
+            dependencies.push({
+                type: 'related_entity',
+                name: metadata.relatedEntityType,
+            });
+        }
+        // Add Visualforce page as dependency (for visualforce template type)
+        let visualforcePage;
+        if (metadata.type === 'visualforce' && metadata.visualforcePage) {
+            visualforcePage = metadata.visualforcePage;
+            dependencies.push({
+                type: 'visualforce_page',
+                name: visualforcePage,
+            });
+        }
+        // Add merge fields as dependencies
+        for (const mergeField of mergeFields) {
+            dependencies.push({
+                type: 'merge_field',
+                name: mergeField.fullReference,
+                objectName: mergeField.objectName,
+                fieldName: mergeField.fieldName,
+            });
+        }
+        // Add custom labels as dependencies
+        for (const label of customLabels) {
+            dependencies.push({
+                type: 'custom_label',
+                name: label,
+            });
+        }
+        // Add attachments as dependencies
+        if (metadata.attachments) {
+            for (const attachment of metadata.attachments) {
+                dependencies.push({
+                    type: 'attachment',
+                    name: attachment.name,
+                });
+            }
+        }
+        if (metadata.attachedContentDocuments) {
+            for (const doc of metadata.attachedContentDocuments) {
+                dependencies.push({
+                    type: 'attachment',
+                    name: doc,
+                });
+            }
+        }
+        // Map attachments to string array (just names) and include attachedContentDocuments
+        const attachmentNames = metadata.attachments?.map((att) => att.name) ?? [];
+        const allAttachments = [...attachmentNames, ...(metadata.attachedContentDocuments ?? [])];
+        const result = {
+            ...metadata,
+            attachments: allAttachments.length > 0 ? allAttachments : undefined,
+            mergeFields,
+            customLabels,
+            dependencies,
+            visualforcePage,
+        };
+        logger.debug(`Parsed email template: ${templateName}`, {
+            templateType: metadata.type,
+            relatedEntityType: !!metadata.relatedEntityType,
+            mergeFieldsCount: mergeFields.length,
+            customLabelsCount: customLabels.length,
+            attachmentsCount: (metadata.attachments?.length ?? 0) + (metadata.attachedContentDocuments?.length ?? 0),
+            dependenciesCount: dependencies.length,
+        });
+        return result;
+    }
+    catch (error) {
+        if (error instanceof ParsingError) {
+            throw error;
+        }
+        throw new ParsingError(`Failed to parse email template: ${templateName}`, {
+            filePath: templateName,
+            originalError: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+//# sourceMappingURL=email-template-parser.js.map

package/lib/parsers/email-template-parser.js.map

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

package/lib/parsers/error-resilient-parser.d.ts

@@ -0,0 +1,110 @@
+/**
+ * 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
+ */
+export type ParseResult<T> = {
+    success: boolean;
+    data?: T;
+    error?: ParseError;
+    filePath: string;
+};
+export type ParseError = {
+    filePath: string;
+    errorType: string;
+    message: string;
+    lineNumber?: number;
+    columnNumber?: number;
+    suggestedFix?: string;
+    stack?: string;
+};
+export type ParserOptions = {
+    /** Stop on first error */
+    failFast: boolean;
+    /** Log errors to aggregator */
+    logErrors: boolean;
+    /** Attempt to suggest fixes */
+    suggestFixes: boolean;
+};
+type ParserFunction<T> = (filePath: string) => Promise<T> | T;
+/**
+ * @ac US-071-AC-1: Catch and log parse errors
+ * @ac US-071-AC-2: Continue with other files
+ */
+export declare class ErrorResilientParser {
+    private readonly options;
+    private readonly errors;
+    constructor(options?: Partial<ParserOptions>);
+    /**
+     * @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
+     */
+    parseFiles<T>(filePaths: string[], parser: ParserFunction<T>): Promise<Array<ParseResult<T>>>;
+    private parseFilesSequentially;
+    /**
+     * @ac US-071-AC-1: Catch and log parse errors
+     * Parse single file with error handling
+     */
+    parseFile<T>(filePath: string, parser: ParserFunction<T>): Promise<ParseResult<T>>;
+    /**
+     * @ac US-071-AC-3: Report errors with file paths
+     * @ac US-071-AC-4: Suggest fixes when possible
+     * Create structured parse error
+     */
+    private createParseError;
+    /**
+     * Categorize error by type
+     */
+    private categorizeError;
+    /**
+     * @ac US-071-AC-4: Suggest fixes when possible
+     * Suggest fix based on error type
+     */
+    private suggestFix;
+    /**
+     * @ac US-071-AC-5: Aggregate error report
+     * Generate comprehensive error report
+     */
+    generateErrorReport(): string;
+    /**
+     * Get all errors
+     */
+    getErrors(): ParseError[];
+    /**
+     * Get error count
+     */
+    getErrorCount(): number;
+    /**
+     * Check if any errors occurred
+     */
+    hasErrors(): boolean;
+    /**
+     * Clear errors
+     */
+    clearErrors(): void;
+    /**
+     * Get successful parse count
+     */
+    static getSuccessCount(results: Array<ParseResult<unknown>>): number;
+    /**
+     * Get failed parse count
+     */
+    static getFailureCount(results: Array<ParseResult<unknown>>): number;
+    /**
+     * Extract only successful results
+     */
+    static getSuccessfulData<T>(results: Array<ParseResult<T>>): T[];
+    /**
+     * Extract only errors
+     */
+    static getErrors(results: Array<ParseResult<unknown>>): ParseError[];
+}
+export {};