@jterrats/smart-deployment 1.0.3

package/lib/monitoring/performance-monitor.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Performance Monitor - US-012
+ * Comprehensive performance monitoring and bottleneck identification
+ *
+ * @ac US-012-AC-1: Execution time tracking
+ * @ac US-012-AC-2: Memory usage tracking
+ * @ac US-012-AC-3: Operation profiling
+ * @ac US-012-AC-4: Performance reports
+ * @ac US-012-AC-5: Bottleneck identification
+ * @ac US-012-AC-6: Benchmark comparisons
+ * @issue #12
+ */
+export type PerformanceMetric = {
+    operation: string;
+    executionTime: number;
+    memoryBefore: number;
+    memoryAfter: number;
+    memoryDelta: number;
+    timestamp: Date;
+    metadata?: Record<string, unknown>;
+};
+export type PerformanceReport = {
+    totalOperations: number;
+    totalTime: number;
+    averageTime: number;
+    slowestOperations: PerformanceMetric[];
+    memoryPeak: number;
+    memoryAverage: number;
+    bottlenecks: Bottleneck[];
+    benchmarks: BenchmarkComparison[];
+};
+export type Bottleneck = {
+    operation: string;
+    executionTime: number;
+    percentage: number;
+    suggestion: string;
+};
+export type BenchmarkComparison = {
+    operation: string;
+    currentTime: number;
+    baselineTime: number;
+    improvement: number;
+    status: 'improved' | 'degraded' | 'stable';
+};
+/**
+ * @ac US-012-AC-1: Execution time tracking
+ * @ac US-012-AC-2: Memory usage tracking
+ * @ac US-012-AC-3: Operation profiling
+ */
+export declare class PerformanceMonitor {
+    private metrics;
+    private baselines;
+    /**
+     * @ac US-012-AC-1: Execution time tracking
+     * Track execution time for an operation
+     */
+    trackOperation<T>(operation: string, fn: () => Promise<T>, metadata?: Record<string, unknown>): Promise<T>;
+    /**
+     * @ac US-012-AC-2: Memory usage tracking
+     * Get current memory usage
+     */
+    private getMemoryUsage;
+    /**
+     * @ac US-012-AC-4: Performance reports
+     * Generate performance report
+     */
+    generateReport(): PerformanceReport;
+    /**
+     * @ac US-012-AC-5: Bottleneck identification
+     * Identify performance bottlenecks
+     */
+    private identifyBottlenecks;
+    /**
+     * Get suggestion for bottleneck
+     */
+    private getSuggestion;
+    /**
+     * @ac US-012-AC-6: Benchmark comparisons
+     * Compare with baseline benchmarks
+     */
+    private compareBenchmarks;
+    /**
+     * Set baseline for benchmarking
+     */
+    setBaseline(operation: string, time: number): void;
+    /**
+     * Format performance report
+     */
+    formatReport(report: PerformanceReport): string;
+    /**
+     * Reset metrics
+     */
+    reset(): void;
+    /**
+     * Get metrics for specific operation
+     */
+    getMetricsForOperation(operation: string): PerformanceMetric[];
+}

package/lib/monitoring/performance-monitor.js

@@ -0,0 +1,260 @@
+/**
+ * Performance Monitor - US-012
+ * Comprehensive performance monitoring and bottleneck identification
+ *
+ * @ac US-012-AC-1: Execution time tracking
+ * @ac US-012-AC-2: Memory usage tracking
+ * @ac US-012-AC-3: Operation profiling
+ * @ac US-012-AC-4: Performance reports
+ * @ac US-012-AC-5: Bottleneck identification
+ * @ac US-012-AC-6: Benchmark comparisons
+ * @issue #12
+ */
+import { performance } from 'node:perf_hooks';
+import { getLogger } from '../utils/logger.js';
+const logger = getLogger('PerformanceMonitor');
+/**
+ * @ac US-012-AC-1: Execution time tracking
+ * @ac US-012-AC-2: Memory usage tracking
+ * @ac US-012-AC-3: Operation profiling
+ */
+export class PerformanceMonitor {
+    metrics = [];
+    baselines = new Map();
+    /**
+     * @ac US-012-AC-1: Execution time tracking
+     * Track execution time for an operation
+     */
+    async trackOperation(operation, fn, metadata) {
+        const memoryBefore = this.getMemoryUsage();
+        const startTime = performance.now();
+        try {
+            const result = await fn();
+            const endTime = performance.now();
+            const memoryAfter = this.getMemoryUsage();
+            const metric = {
+                operation,
+                executionTime: endTime - startTime,
+                memoryBefore,
+                memoryAfter,
+                memoryDelta: memoryAfter - memoryBefore,
+                timestamp: new Date(),
+                metadata,
+            };
+            this.metrics.push(metric);
+            logger.debug('Operation tracked', {
+                operation,
+                executionTime: metric.executionTime,
+                memoryDelta: metric.memoryDelta,
+            });
+            return result;
+        }
+        catch (error) {
+            const endTime = performance.now();
+            const memoryAfter = this.getMemoryUsage();
+            const metric = {
+                operation,
+                executionTime: endTime - startTime,
+                memoryBefore,
+                memoryAfter,
+                memoryDelta: memoryAfter - memoryBefore,
+                timestamp: new Date(),
+                metadata: {
+                    ...metadata,
+                    error: error instanceof Error ? error.message : String(error),
+                },
+            };
+            this.metrics.push(metric);
+            throw error;
+        }
+    }
+    /**
+     * @ac US-012-AC-2: Memory usage tracking
+     * Get current memory usage
+     */
+    getMemoryUsage() {
+        const usage = process.memoryUsage();
+        return usage.heapUsed;
+    }
+    /**
+     * @ac US-012-AC-4: Performance reports
+     * Generate performance report
+     */
+    generateReport() {
+        if (this.metrics.length === 0) {
+            return {
+                totalOperations: 0,
+                totalTime: 0,
+                averageTime: 0,
+                slowestOperations: [],
+                memoryPeak: 0,
+                memoryAverage: 0,
+                bottlenecks: [],
+                benchmarks: [],
+            };
+        }
+        const totalTime = this.metrics.reduce((sum, m) => sum + m.executionTime, 0);
+        const averageTime = totalTime / this.metrics.length;
+        // Find slowest operations
+        const slowestOperations = [...this.metrics].sort((a, b) => b.executionTime - a.executionTime).slice(0, 10);
+        // Calculate memory stats
+        const memoryValues = this.metrics.map((m) => m.memoryAfter);
+        const memoryPeak = Math.max(...memoryValues);
+        const memoryAverage = memoryValues.reduce((sum, m) => sum + m, 0) / memoryValues.length;
+        // Identify bottlenecks
+        const bottlenecks = this.identifyBottlenecks(totalTime);
+        // Compare with benchmarks
+        const benchmarks = this.compareBenchmarks();
+        logger.info('Performance report generated', {
+            totalOperations: this.metrics.length,
+            totalTime,
+            averageTime,
+            bottlenecks: bottlenecks.length,
+        });
+        return {
+            totalOperations: this.metrics.length,
+            totalTime,
+            averageTime,
+            slowestOperations,
+            memoryPeak,
+            memoryAverage,
+            bottlenecks,
+            benchmarks,
+        };
+    }
+    /**
+     * @ac US-012-AC-5: Bottleneck identification
+     * Identify performance bottlenecks
+     */
+    identifyBottlenecks(totalTime) {
+        const bottlenecks = [];
+        // Group by operation
+        const operationGroups = new Map();
+        for (const metric of this.metrics) {
+            const existing = operationGroups.get(metric.operation) ?? [];
+            existing.push(metric);
+            operationGroups.set(metric.operation, existing);
+        }
+        for (const [operation, metrics] of operationGroups.entries()) {
+            const operationTotalTime = metrics.reduce((sum, m) => sum + m.executionTime, 0);
+            const percentage = (operationTotalTime / totalTime) * 100;
+            // Consider bottleneck if > 20% of total time or > 1 second average
+            const averageTime = operationTotalTime / metrics.length;
+            if (percentage > 20 || averageTime > 1000) {
+                bottlenecks.push({
+                    operation,
+                    executionTime: operationTotalTime,
+                    percentage,
+                    suggestion: this.getSuggestion(operation, averageTime, percentage),
+                });
+            }
+        }
+        return bottlenecks.sort((a, b) => b.percentage - a.percentage);
+    }
+    /**
+     * Get suggestion for bottleneck
+     */
+    getSuggestion(operation, averageTime, percentage) {
+        if (percentage > 50) {
+            return `Consider optimizing ${operation} - it takes ${percentage.toFixed(1)}% of total time`;
+        }
+        if (averageTime > 5000) {
+            return `Consider caching or parallelizing ${operation} - average time: ${averageTime.toFixed(0)}ms`;
+        }
+        return `Review ${operation} for optimization opportunities`;
+    }
+    /**
+     * @ac US-012-AC-6: Benchmark comparisons
+     * Compare with baseline benchmarks
+     */
+    compareBenchmarks() {
+        const comparisons = [];
+        // Group by operation
+        const operationGroups = new Map();
+        for (const metric of this.metrics) {
+            const existing = operationGroups.get(metric.operation) ?? [];
+            existing.push(metric);
+            operationGroups.set(metric.operation, existing);
+        }
+        for (const [operation, metrics] of operationGroups.entries()) {
+            const currentTime = metrics.reduce((sum, m) => sum + m.executionTime, 0) / metrics.length;
+            const baselineTime = this.baselines.get(operation);
+            if (baselineTime) {
+                const improvement = ((baselineTime - currentTime) / baselineTime) * 100;
+                let status = 'stable';
+                if (improvement > 10) {
+                    status = 'improved';
+                }
+                else if (improvement < -10) {
+                    status = 'degraded';
+                }
+                comparisons.push({
+                    operation,
+                    currentTime,
+                    baselineTime,
+                    improvement,
+                    status,
+                });
+            }
+        }
+        return comparisons;
+    }
+    /**
+     * Set baseline for benchmarking
+     */
+    setBaseline(operation, time) {
+        this.baselines.set(operation, time);
+        logger.debug('Baseline set', { operation, time });
+    }
+    /**
+     * Format performance report
+     */
+    formatReport(report) {
+        const lines = [];
+        lines.push('⚡ Performance Report');
+        lines.push('═══════════════════════════════════════');
+        lines.push(`Total Operations: ${report.totalOperations}`);
+        lines.push(`Total Time: ${report.totalTime.toFixed(2)}ms`);
+        lines.push(`Average Time: ${report.averageTime.toFixed(2)}ms`);
+        lines.push(`Memory Peak: ${(report.memoryPeak / 1024 / 1024).toFixed(2)} MB`);
+        lines.push(`Memory Average: ${(report.memoryAverage / 1024 / 1024).toFixed(2)} MB`);
+        lines.push('');
+        if (report.slowestOperations.length > 0) {
+            lines.push('🐌 Slowest Operations:');
+            for (const [index, op] of report.slowestOperations.slice(0, 5).entries()) {
+                lines.push(`  ${index + 1}. ${op.operation}: ${op.executionTime.toFixed(2)}ms`);
+            }
+            lines.push('');
+        }
+        if (report.bottlenecks.length > 0) {
+            lines.push('⚠️  Bottlenecks:');
+            for (const bottleneck of report.bottlenecks) {
+                lines.push(`  • ${bottleneck.operation}: ${bottleneck.percentage.toFixed(1)}%`);
+                lines.push(`    ${bottleneck.suggestion}`);
+            }
+            lines.push('');
+        }
+        if (report.benchmarks.length > 0) {
+            lines.push('📊 Benchmark Comparisons:');
+            for (const benchmark of report.benchmarks) {
+                const icon = benchmark.status === 'improved' ? '✅' : benchmark.status === 'degraded' ? '❌' : '➡️';
+                lines.push(`  ${icon} ${benchmark.operation}: ${benchmark.improvement.toFixed(1)}%`);
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Reset metrics
+     */
+    reset() {
+        this.metrics = [];
+        logger.info('Performance metrics reset');
+    }
+    /**
+     * Get metrics for specific operation
+     */
+    getMetricsForOperation(operation) {
+        return this.metrics.filter((m) => m.operation === operation);
+    }
+}
+//# sourceMappingURL=performance-monitor.js.map

package/lib/monitoring/performance-monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance-monitor.js","sourceRoot":"","sources":["../../src/monitoring/performance-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,MAAM,GAAG,SAAS,CAAC,oBAAoB,CAAC,CAAC;AAsC/C;;;;GAIG;AACH,MAAM,OAAO,kBAAkB;IACrB,OAAO,GAAwB,EAAE,CAAC;IAClC,SAAS,GAAwB,IAAI,GAAG,EAAE,CAAC;IAEnD;;;OAGG;IACI,KAAK,CAAC,cAAc,CACzB,SAAiB,EACjB,EAAoB,EACpB,QAAkC;QAElC,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAEpC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YAClC,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;YAE1C,MAAM,MAAM,GAAsB;gBAChC,SAAS;gBACT,aAAa,EAAE,OAAO,GAAG,SAAS;gBAClC,YAAY;gBACZ,WAAW;gBACX,WAAW,EAAE,WAAW,GAAG,YAAY;gBACvC,SAAS,EAAE,IAAI,IAAI,EAAE;gBACrB,QAAQ;aACT,CAAC;YAEF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE;gBAChC,SAAS;gBACT,aAAa,EAAE,MAAM,CAAC,aAAa;gBACnC,WAAW,EAAE,MAAM,CAAC,WAAW;aAChC,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YAClC,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;YAE1C,MAAM,MAAM,GAAsB;gBAChC,SAAS;gBACT,aAAa,EAAE,OAAO,GAAG,SAAS;gBAClC,YAAY;gBACZ,WAAW;gBACX,WAAW,EAAE,WAAW,GAAG,YAAY;gBACvC,SAAS,EAAE,IAAI,IAAI,EAAE;gBACrB,QAAQ,EAAE;oBACR,GAAG,QAAQ;oBACX,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBAC9D;aACF,CAAC;YAEF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,cAAc;QACpB,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACpC,OAAO,KAAK,CAAC,QAAQ,CAAC;IACxB,CAAC;IAED;;;OAGG;IACI,cAAc;QACnB,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO;gBACL,eAAe,EAAE,CAAC;gBAClB,SAAS,EAAE,CAAC;gBACZ,WAAW,EAAE,CAAC;gBACd,iBAAiB,EAAE,EAAE;gBACrB,UAAU,EAAE,CAAC;gBACb,aAAa,EAAE,CAAC;gBAChB,WAAW,EAAE,EAAE;gBACf,UAAU,EAAE,EAAE;aACf,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAC5E,MAAM,WAAW,GAAG,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QAEpD,0BAA0B;QAC1B,MAAM,iBAAiB,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAE3G,yBAAyB;QACzB,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC;QAC7C,MAAM,aAAa,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC;QAExF,uBAAuB;QACvB,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;QAExD,0BAA0B;QAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAE5C,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE;YAC1C,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;YACpC,SAAS;YACT,WAAW;YACX,WAAW,EAAE,WAAW,CAAC,MAAM;SAChC,CAAC,CAAC;QAEH,OAAO;YACL,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;YACpC,SAAS;YACT,WAAW;YACX,iBAAiB;YACjB,UAAU;YACV,aAAa;YACb,WAAW;YACX,UAAU;SACX,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,mBAAmB,CAAC,SAAiB;QAC3C,MAAM,WAAW,GAAiB,EAAE,CAAC;QAErC,qBAAqB;QACrB,MAAM,eAAe,GAAG,IAAI,GAAG,EAA+B,CAAC;QAC/D,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YAC7D,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtB,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAClD,CAAC;QAED,KAAK,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,eAAe,CAAC,OAAO,EAAE,EAAE,CAAC;YAC7D,MAAM,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;YAChF,MAAM,UAAU,GAAG,CAAC,kBAAkB,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC;YAE1D,mEAAmE;YACnE,MAAM,WAAW,GAAG,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;YACxD,IAAI,UAAU,GAAG,EAAE,IAAI,WAAW,GAAG,IAAI,EAAE,CAAC;gBAC1C,WAAW,CAAC,IAAI,CAAC;oBACf,SAAS;oBACT,aAAa,EAAE,kBAAkB;oBACjC,UAAU;oBACV,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,WAAW,EAAE,UAAU,CAAC;iBACnE,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,SAAiB,EAAE,WAAmB,EAAE,UAAkB;QAC9E,IAAI,UAAU,GAAG,EAAE,EAAE,CAAC;YACpB,OAAO,uBAAuB,SAAS,eAAe,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC;QAC/F,CAAC;QAED,IAAI,WAAW,GAAG,IAAI,EAAE,CAAC;YACvB,OAAO,qCAAqC,SAAS,oBAAoB,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QACtG,CAAC;QAED,OAAO,UAAU,SAAS,iCAAiC,CAAC;IAC9D,CAAC;IAED;;;OAGG;IACK,iBAAiB;QACvB,MAAM,WAAW,GAA0B,EAAE,CAAC;QAE9C,qBAAqB;QACrB,MAAM,eAAe,GAAG,IAAI,GAAG,EAA+B,CAAC;QAC/D,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YAC7D,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtB,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAClD,CAAC;QAED,KAAK,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,eAAe,CAAC,OAAO,EAAE,EAAE,CAAC;YAC7D,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;YAC1F,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAEnD,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,WAAW,GAAG,CAAC,CAAC,YAAY,GAAG,WAAW,CAAC,GAAG,YAAY,CAAC,GAAG,GAAG,CAAC;gBACxE,IAAI,MAAM,GAAuC,QAAQ,CAAC;gBAE1D,IAAI,WAAW,GAAG,EAAE,EAAE,CAAC;oBACrB,MAAM,GAAG,UAAU,CAAC;gBACtB,CAAC;qBAAM,IAAI,WAAW,GAAG,CAAC,EAAE,EAAE,CAAC;oBAC7B,MAAM,GAAG,UAAU,CAAC;gBACtB,CAAC;gBAED,WAAW,CAAC,IAAI,CAAC;oBACf,SAAS;oBACT,WAAW;oBACX,YAAY;oBACZ,WAAW;oBACX,MAAM;iBACP,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,SAAiB,EAAE,IAAY;QAChD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACpC,MAAM,CAAC,KAAK,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACI,YAAY,CAAC,MAAyB;QAC3C,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/D,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,UAAU,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC9E,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,aAAa,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACpF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,IAAI,MAAM,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;YACrC,KAAK,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;gBACzE,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,SAAS,KAAK,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAClF,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAC/B,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBAC5C,KAAK,CAAC,IAAI,CAAC,OAAO,UAAU,CAAC,SAAS,KAAK,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBAChF,KAAK,CAAC,IAAI,CAAC,OAAO,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC;YAC7C,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;YACxC,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBAC1C,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;gBAClG,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,SAAS,CAAC,SAAS,KAAK,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACvF,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACI,KAAK;QACV,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACI,sBAAsB,CAAC,SAAiB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;IAC/D,CAAC;CACF"}

package/lib/parsers/apex-class-parser.d.ts

@@ -0,0 +1,47 @@
+import type { ApexClassMetadata } from '../types/salesforce/apex.js';
+/**
+ * Apex class dependency types
+ */
+export type ApexDependencyType = 'extends' | 'implements' | 'static_method' | 'instantiation' | 'variable_declaration' | 'inner_class' | 'dynamic_instantiation';
+/**
+ * Represents a dependency found in an Apex class
+ */
+export type ApexDependency = {
+    type: ApexDependencyType;
+    className: string;
+    lineNumber?: number;
+    isStandard: boolean;
+    isManagedPackage: boolean;
+    namespace?: string;
+};
+/**
+ * Result of parsing an Apex class
+ * Optionally includes metadata from .cls-meta.xml
+ */
+export type ApexParseResult = {
+    className: string;
+    namespace?: string;
+    extends?: string;
+    implements: string[];
+    dependencies: ApexDependency[];
+    innerClasses: string[];
+    metadata?: ApexClassMetadata;
+};
+/**
+ * Parse an Apex class file and extract dependencies
+ *
+ * @param filePath - Path to the Apex class file
+ * @param content - Content of the Apex class file
+ * @returns ApexParseResult with all extracted dependencies
+ *
+ * @throws {ParsingError} If the file cannot be parsed
+ *
+ * @example
+ * ```typescript
+ * const result = parseApexClass('MyController.cls', apexCode);
+ * console.log(result.extends); // 'BaseController'
+ * console.log(result.implements); // ['IController', 'ICallable']
+ * console.log(result.dependencies.length); // 5
+ * ```
+ */
+export declare function parseApexClass(filePath: string, content: string): ApexParseResult;