@jterrats/smart-deployment 1.0.3

package/lib/scanner/custom-structure-scanner.js

@@ -0,0 +1,229 @@
+/**
+ * Custom Structure Scanner - US-081
+ * Support non-standard SFDX project structures
+ *
+ * @ac US-081-AC-1: Detect custom package directories
+ * @ac US-081-AC-2: Support custom naming conventions
+ * @ac US-081-AC-3: Handle nested structures
+ * @ac US-081-AC-4: Support legacy structures
+ * @ac US-081-AC-5: Validate custom paths
+ * @ac US-081-AC-6: Generate structure report
+ * @issue #81
+ */
+import { promises as fs } from 'node:fs';
+import * as path from 'node:path';
+import { getLogger } from '../utils/logger.js';
+const logger = getLogger('CustomStructureScanner');
+/**
+ * @ac US-081-AC-1: Detect custom package directories
+ */
+export class CustomStructureScanner {
+    /**
+     * @ac US-081-AC-1: Detect custom package directories
+     * Scan for custom package directories
+     */
+    async detectCustomPackageDirs(projectRoot) {
+        logger.info('Detecting custom package directories', { projectRoot });
+        const customDirs = [];
+        try {
+            // Check sfdx-project.json
+            const sfdxProjectPath = path.join(projectRoot, 'sfdx-project.json');
+            const content = await fs.readFile(sfdxProjectPath, 'utf-8');
+            const config = JSON.parse(content);
+            if (config.packageDirectories) {
+                for (const pkg of config.packageDirectories) {
+                    if (pkg.path) {
+                        customDirs.push(pkg.path);
+                    }
+                }
+            }
+            // Also scan for common patterns
+            const commonDirs = ['force-app', 'src', 'main', 'apps', 'packages'];
+            const existingCommonDirs = await Promise.all(commonDirs.map(async (dir) => {
+                const fullPath = path.join(projectRoot, dir);
+                try {
+                    await fs.access(fullPath);
+                    return dir;
+                }
+                catch {
+                    return undefined;
+                }
+            }));
+            for (const dir of existingCommonDirs) {
+                if (dir && !customDirs.includes(dir)) {
+                    customDirs.push(dir);
+                }
+            }
+        }
+        catch (error) {
+            logger.warn('Error detecting custom package dirs', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+        logger.info('Custom package directories detected', { count: customDirs.length });
+        return customDirs;
+    }
+    /**
+     * @ac US-081-AC-2: Support custom naming conventions
+     * Detect naming convention
+     */
+    detectNamingConvention(directories) {
+        const standardPatterns = ['force-app', 'main/default', 'src'];
+        const hasStandard = directories.some((dir) => standardPatterns.some((pattern) => dir.includes(pattern)));
+        return hasStandard ? 'standard' : 'custom';
+    }
+    /**
+     * @ac US-081-AC-3: Handle nested structures
+     * Check if structure is nested
+     */
+    async isNestedStructure(projectRoot, packageDirs) {
+        const nestedResults = await Promise.all(packageDirs.map(async (dir) => {
+            const fullPath = path.join(projectRoot, dir);
+            try {
+                const entries = await fs.readdir(fullPath, { withFileTypes: true });
+                const subDirs = entries.filter((e) => e.isDirectory());
+                const hasMetadataSubdirs = subDirs.some((d) => ['classes', 'triggers', 'objects', 'lwc', 'aura'].includes(d.name));
+                if (hasMetadataSubdirs) {
+                    return false;
+                }
+                const nestedMatches = await Promise.all(subDirs.map(async (subDir) => {
+                    const subPath = path.join(fullPath, subDir.name);
+                    const subEntries = await fs.readdir(subPath, { withFileTypes: true });
+                    return subEntries.some((e) => ['classes', 'triggers', 'objects'].includes(e.name));
+                }));
+                return nestedMatches.some(Boolean);
+            }
+            catch {
+                return false;
+            }
+        }));
+        return nestedResults.some(Boolean);
+    }
+    /**
+     * @ac US-081-AC-4: Support legacy structures
+     * Detect legacy structure (Metadata API format)
+     */
+    async isLegacyStructure(projectRoot) {
+        try {
+            // Check for package.xml
+            await fs.access(path.join(projectRoot, 'package.xml'));
+            return true;
+        }
+        catch {
+            // Check for src/ directory (old format)
+            try {
+                await fs.access(path.join(projectRoot, 'src'));
+                // Check if it's really legacy or just a custom dir name
+                const packageXml = path.join(projectRoot, 'src', 'package.xml');
+                await fs.access(packageXml);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        }
+    }
+    /**
+     * @ac US-081-AC-5: Validate custom paths
+     * Validate custom paths exist and are accessible
+     */
+    async validateCustomPaths(projectRoot, customPaths) {
+        const errors = [];
+        const validationResults = await Promise.all(Object.entries(customPaths).map(async ([key, customPath]) => {
+            const fullPath = path.join(projectRoot, customPath);
+            try {
+                await fs.access(fullPath);
+                return undefined;
+            }
+            catch {
+                return `Custom path not found: ${key} -> ${customPath}`;
+            }
+        }));
+        errors.push(...validationResults.filter((result) => result !== undefined));
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+    /**
+     * @ac US-081-AC-6: Generate structure report
+     * Scan and generate comprehensive structure report
+     */
+    async scanStructure(projectRoot) {
+        logger.info('Scanning custom structure', { projectRoot });
+        const packageDirs = await this.detectCustomPackageDirs(projectRoot);
+        const namingConvention = this.detectNamingConvention(packageDirs);
+        const isNested = await this.isNestedStructure(projectRoot, packageDirs);
+        const isLegacy = await this.isLegacyStructure(projectRoot);
+        const warnings = [];
+        const recommendations = [];
+        // Generate warnings
+        if (namingConvention === 'custom') {
+            warnings.push('Custom naming convention detected - may affect deployment');
+        }
+        if (isNested) {
+            warnings.push('Nested structure detected - ensure proper scanning depth');
+        }
+        if (isLegacy) {
+            warnings.push('Legacy Metadata API format detected');
+            recommendations.push('Consider migrating to SFDX source format');
+        }
+        // Generate recommendations
+        if (packageDirs.length === 0) {
+            recommendations.push('No package directories found - check sfdx-project.json');
+        }
+        if (packageDirs.length > 5) {
+            recommendations.push('Many package directories - consider consolidating');
+        }
+        const structure = {
+            packageDirs,
+            namingConvention,
+            isNested,
+            isLegacy,
+            customPaths: {},
+        };
+        logger.info('Structure scan complete', {
+            packageDirs: packageDirs.length,
+            namingConvention,
+            isNested,
+            isLegacy,
+        });
+        return {
+            structure,
+            warnings,
+            recommendations,
+        };
+    }
+    /**
+     * Format structure report
+     */
+    formatReport(report) {
+        const lines = [];
+        lines.push('📂 Project Structure Report');
+        lines.push('═══════════════════════════════════════');
+        lines.push(`Package Directories: ${report.structure.packageDirs.length}`);
+        for (const dir of report.structure.packageDirs) {
+            lines.push(`  • ${dir}`);
+        }
+        lines.push('');
+        lines.push(`Naming Convention: ${report.structure.namingConvention}`);
+        lines.push(`Nested Structure: ${report.structure.isNested ? 'Yes' : 'No'}`);
+        lines.push(`Legacy Format: ${report.structure.isLegacy ? 'Yes' : 'No'}`);
+        lines.push('');
+        if (report.warnings.length > 0) {
+            lines.push('⚠️  Warnings:');
+            for (const warning of report.warnings) {
+                lines.push(`  • ${warning}`);
+            }
+            lines.push('');
+        }
+        if (report.recommendations.length > 0) {
+            lines.push('💡 Recommendations:');
+            for (const rec of report.recommendations) {
+                lines.push(`  • ${rec}`);
+            }
+        }
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=custom-structure-scanner.js.map

package/lib/scanner/custom-structure-scanner.js.map

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

package/lib/scanner/forceignore-parser.d.ts

@@ -0,0 +1,69 @@
+/**
+ * .forceignore Parser - US-083
+ * Parses and applies .forceignore rules to filter metadata
+ *
+ * @ac US-083-AC-1: Parse .forceignore syntax
+ * @ac US-083-AC-2: Support glob patterns
+ * @ac US-083-AC-3: Support negation (!)
+ * @ac US-083-AC-4: Support comments (#)
+ * @ac US-083-AC-5: Respect .gitignore format
+ * @ac US-083-AC-6: Test against file paths
+ * @issue #83
+ */
+export type ForceIgnoreRule = {
+    pattern: string;
+    isNegation: boolean;
+    lineNumber: number;
+};
+export type ForceIgnoreResult = {
+    found: boolean;
+    filePath: string;
+    rules: ForceIgnoreRule[];
+    totalRules: number;
+    commentLines: number;
+    emptyLines: number;
+};
+/**
+ * @ac US-083-AC-1: Parse .forceignore syntax
+ * @ac US-083-AC-2: Support glob patterns
+ */
+export declare class ForceIgnoreParser {
+    private static readonly FORCEIGNORE_FILE;
+    private rules;
+    private projectRoot;
+    /**
+     * Load and parse .forceignore file
+     */
+    load(projectRoot: string): Promise<ForceIgnoreResult>;
+    /**
+     * @ac US-083-AC-1: Parse .forceignore syntax
+     * @ac US-083-AC-3: Support negation (!)
+     * @ac US-083-AC-4: Support comments (#)
+     */
+    private parseContent;
+    /**
+     * @ac US-083-AC-6: Test against file paths
+     * Check if a file path is ignored using minimatch
+     */
+    isIgnored(filePath: string): boolean;
+    /**
+     * Filter an array of file paths based on .forceignore rules
+     */
+    filterPaths(paths: string[]): string[];
+    /**
+     * Get relative path from project root
+     */
+    private getRelativePath;
+    /**
+     * Get all loaded rules
+     */
+    getRules(): ForceIgnoreRule[];
+    /**
+     * Check if .forceignore is loaded
+     */
+    isLoaded(): boolean;
+    /**
+     * Generate report of loaded rules
+     */
+    formatReport(result: ForceIgnoreResult): string;
+}

package/lib/scanner/forceignore-parser.js

@@ -0,0 +1,195 @@
+/**
+ * .forceignore Parser - US-083
+ * Parses and applies .forceignore rules to filter metadata
+ *
+ * @ac US-083-AC-1: Parse .forceignore syntax
+ * @ac US-083-AC-2: Support glob patterns
+ * @ac US-083-AC-3: Support negation (!)
+ * @ac US-083-AC-4: Support comments (#)
+ * @ac US-083-AC-5: Respect .gitignore format
+ * @ac US-083-AC-6: Test against file paths
+ * @issue #83
+ */
+import { readFile, access } from 'node:fs/promises';
+import { resolve, relative, sep } from 'node:path';
+import { minimatch } from 'minimatch';
+import { getLogger } from '../utils/logger.js';
+const logger = getLogger('ForceIgnoreParser');
+/**
+ * @ac US-083-AC-1: Parse .forceignore syntax
+ * @ac US-083-AC-2: Support glob patterns
+ */
+export class ForceIgnoreParser {
+    static FORCEIGNORE_FILE = '.forceignore';
+    rules = [];
+    projectRoot = '';
+    /**
+     * Load and parse .forceignore file
+     */
+    async load(projectRoot) {
+        this.projectRoot = projectRoot;
+        const filePath = resolve(projectRoot, ForceIgnoreParser.FORCEIGNORE_FILE);
+        const result = {
+            found: false,
+            filePath,
+            rules: [],
+            totalRules: 0,
+            commentLines: 0,
+            emptyLines: 0,
+        };
+        try {
+            await access(filePath);
+            result.found = true;
+        }
+        catch {
+            logger.debug('.forceignore not found', { projectRoot });
+            return result;
+        }
+        try {
+            const content = await readFile(filePath, 'utf-8');
+            const parseResult = this.parseContent(content);
+            this.rules = parseResult.rules;
+            result.rules = parseResult.rules;
+            result.totalRules = parseResult.totalRules;
+            result.commentLines = parseResult.commentLines;
+            result.emptyLines = parseResult.emptyLines;
+            logger.info('.forceignore loaded', {
+                rules: result.totalRules,
+                comments: result.commentLines,
+            });
+            return result;
+        }
+        catch (error) {
+            logger.error('Failed to parse .forceignore', { error });
+            throw new Error(`Failed to parse .forceignore: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * @ac US-083-AC-1: Parse .forceignore syntax
+     * @ac US-083-AC-3: Support negation (!)
+     * @ac US-083-AC-4: Support comments (#)
+     */
+    parseContent(content) {
+        const lines = content.split('\n');
+        const rules = [];
+        let commentLines = 0;
+        let emptyLines = 0;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i].trim();
+            const lineNumber = i + 1;
+            // Skip empty lines
+            if (line.length === 0) {
+                emptyLines++;
+                continue;
+            }
+            // Skip comments
+            if (line.startsWith('#')) {
+                commentLines++;
+                continue;
+            }
+            // Handle negation
+            const isNegation = line.startsWith('!');
+            const pattern = isNegation ? line.slice(1) : line;
+            rules.push({
+                pattern,
+                isNegation,
+                lineNumber,
+            });
+        }
+        return {
+            rules,
+            totalRules: rules.length,
+            commentLines,
+            emptyLines,
+        };
+    }
+    /**
+     * @ac US-083-AC-6: Test against file paths
+     * Check if a file path is ignored using minimatch
+     */
+    isIgnored(filePath) {
+        if (this.rules.length === 0) {
+            return false;
+        }
+        // Get relative path from project root
+        const relativePath = this.getRelativePath(filePath);
+        let ignored = false;
+        // Apply rules in order (later rules override earlier ones)
+        for (const rule of this.rules) {
+            // Use minimatch for glob matching (industry standard)
+            const matches = minimatch(relativePath, rule.pattern, {
+                dot: true, // Match dotfiles
+                matchBase: true, // Match basename
+            });
+            if (matches) {
+                ignored = !rule.isNegation;
+            }
+        }
+        return ignored;
+    }
+    /**
+     * Filter an array of file paths based on .forceignore rules
+     */
+    filterPaths(paths) {
+        if (this.rules.length === 0) {
+            return paths;
+        }
+        return paths.filter((path) => !this.isIgnored(path));
+    }
+    /**
+     * Get relative path from project root
+     */
+    getRelativePath(filePath) {
+        const absolutePath = resolve(filePath);
+        const projectRoot = resolve(this.projectRoot);
+        let relativePath = relative(projectRoot, absolutePath);
+        // Normalize path separators to forward slashes
+        relativePath = relativePath.split(sep).join('/');
+        return relativePath;
+    }
+    /**
+     * Get all loaded rules
+     */
+    getRules() {
+        return [...this.rules];
+    }
+    /**
+     * Check if .forceignore is loaded
+     */
+    isLoaded() {
+        return this.rules.length > 0 || this.projectRoot.length > 0;
+    }
+    /**
+     * Generate report of loaded rules
+     */
+    formatReport(result) {
+        const lines = [];
+        lines.push('🚫 .forceignore Report');
+        lines.push('═══════════════════════════════════════');
+        if (!result.found) {
+            lines.push('⚠️  .forceignore not found');
+            lines.push('💡 All files will be included in deployment');
+            return lines.join('\n');
+        }
+        lines.push(`✅ .forceignore loaded: ${result.filePath}`);
+        lines.push('');
+        lines.push('📊 Statistics:');
+        lines.push(`   Active Rules: ${result.totalRules}`);
+        lines.push(`   Comment Lines: ${result.commentLines}`);
+        lines.push(`   Empty Lines: ${result.emptyLines}`);
+        lines.push('');
+        if (result.rules.length > 0) {
+            lines.push('📋 Rules:');
+            for (const rule of result.rules.slice(0, 20)) {
+                // Show first 20
+                const prefix = rule.isNegation ? '!' : ' ';
+                lines.push(`   ${prefix} ${rule.pattern}`);
+            }
+            if (result.rules.length > 20) {
+                lines.push(`   ... and ${result.rules.length - 20} more`);
+            }
+        }
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=forceignore-parser.js.map

package/lib/scanner/forceignore-parser.js.map

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

package/lib/scanner/metadata-format-scanner.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Metadata API Format Scanner - US-080
+ * Supports legacy Metadata API format (package.xml + src/)
+ *
+ * @ac US-080-AC-1: Detect package.xml
+ * @ac US-080-AC-2: Scan src/ directory
+ * @ac US-080-AC-3: Parse metadata format files
+ * @ac US-080-AC-4: Convert to source format internally
+ * @ac US-080-AC-5: Handle Documents folder structure
+ * @ac US-080-AC-6: Handle DigitalExperience bundles
+ * @issue #80
+ */
+import type { MetadataComponent } from '../types/metadata.js';
+export type MetadataFormatScanResult = {
+    format: 'metadata-api' | 'source-format' | 'mixed';
+    packageXmlPath?: string;
+    srcDirectory?: string;
+    components: MetadataComponent[];
+    warnings: string[];
+    executionTime: number;
+};
+export type PackageXmlEntry = {
+    name: string;
+    type: string;
+};
+/**
+ * @ac US-080-AC-1: Detect package.xml
+ * @ac US-080-AC-2: Scan src/ directory
+ */
+export declare class MetadataFormatScanner {
+    private readonly errorAggregator;
+    /**
+     * @ac US-080-AC-1: Detect package.xml
+     * Check if project uses Metadata API format
+     */
+    detectFormat(projectRoot: string): 'metadata-api' | 'source-format' | 'mixed';
+    /**
+     * @ac US-080-AC-2: Scan src/ directory
+     * Scan Metadata API format project
+     */
+    scan(projectRoot: string): Promise<MetadataFormatScanResult>;
+    /**
+     * @ac US-080-AC-3: Parse metadata format files
+     * Parse package.xml
+     */
+    private parsePackageXml;
+    /**
+     * @ac US-080-AC-2: Scan src/ directory
+     * @ac US-080-AC-4: Convert to source format internally
+     * Scan Metadata API src/ directory
+     */
+    private scanSrcDirectory;
+    /**
+     * @ac US-080-AC-3: Parse metadata format files
+     * Scan specific metadata type directory
+     */
+    private scanTypeDirectory;
+    /**
+     * @ac US-080-AC-5: Handle Documents folder structure
+     * @ac US-080-AC-6: Handle DigitalExperience bundles
+     * Scan bundle directory (for Documents, DigitalExperience, etc.)
+     */
+    private scanBundleDirectory;
+    /**
+     * @ac US-080-AC-4: Convert to source format internally
+     * Map Metadata API directory name to MetadataType
+     */
+    private mapDirectoryToType;
+    /**
+     * Extract component name from filename
+     */
+    private extractComponentName;
+    /**
+     * Get error report
+     */
+    getErrorReport(): string;
+}