xypriss 1.0.0 → 1.1.0

package/dist/esm/mods/security/src/utils/performanceMonitor.js

@@ -0,0 +1,246 @@
+/**
+ * Performance Monitoring Utilities for XyPrissSecurity
+ * Monitor and optimize cryptographic operations performance
+ */
+/**
+ * Performance monitor for cryptographic operations
+ */
+class CryptoPerformanceMonitor {
+    constructor() {
+        this.metrics = [];
+        this.activeOperations = new Map();
+        this.benchmarks = new Map();
+    }
+    /**
+     * Start monitoring an operation
+     */
+    startOperation(operationId, operationName, metadata) {
+        const metric = {
+            operationName,
+            startTime: process.hrtime.bigint(),
+            memoryUsage: process.memoryUsage(),
+            cpuUsage: process.cpuUsage(),
+            success: false,
+            ...metadata,
+        };
+        this.activeOperations.set(operationId, metric);
+    }
+    /**
+     * End monitoring an operation
+     */
+    endOperation(operationId, success = true, errorType) {
+        const metric = this.activeOperations.get(operationId);
+        if (!metric) {
+            console.warn(`No active operation found for ID: ${operationId}`);
+            return null;
+        }
+        metric.endTime = process.hrtime.bigint();
+        metric.duration = Number(metric.endTime - metric.startTime) / 1000000; // Convert to milliseconds
+        metric.success = success;
+        metric.errorType = errorType;
+        // Calculate memory and CPU usage
+        const currentMemory = process.memoryUsage();
+        const currentCpu = process.cpuUsage(metric.cpuUsage);
+        metric.memoryUsage = {
+            rss: currentMemory.rss - (metric.memoryUsage?.rss || 0),
+            heapTotal: currentMemory.heapTotal - (metric.memoryUsage?.heapTotal || 0),
+            heapUsed: currentMemory.heapUsed - (metric.memoryUsage?.heapUsed || 0),
+            external: currentMemory.external - (metric.memoryUsage?.external || 0),
+            arrayBuffers: currentMemory.arrayBuffers -
+                (metric.memoryUsage?.arrayBuffers || 0),
+        };
+        metric.cpuUsage = currentCpu;
+        this.metrics.push(metric);
+        this.activeOperations.delete(operationId);
+        return metric;
+    }
+    /**
+     * Get performance statistics for an operation type
+     */
+    getOperationStats(operationName) {
+        const operationMetrics = this.metrics.filter((m) => m.operationName === operationName);
+        if (operationMetrics.length === 0) {
+            return {
+                totalOperations: 0,
+                successfulOperations: 0,
+                failedOperations: 0,
+                avgDuration: 0,
+                minDuration: 0,
+                maxDuration: 0,
+                successRate: 0,
+                avgMemoryUsage: 0,
+            };
+        }
+        const successful = operationMetrics.filter((m) => m.success);
+        const durations = operationMetrics.map((m) => m.duration || 0);
+        const memoryUsages = operationMetrics.map((m) => m.memoryUsage?.heapUsed || 0);
+        return {
+            totalOperations: operationMetrics.length,
+            successfulOperations: successful.length,
+            failedOperations: operationMetrics.length - successful.length,
+            avgDuration: durations.reduce((a, b) => a + b, 0) / durations.length,
+            minDuration: Math.min(...durations),
+            maxDuration: Math.max(...durations),
+            successRate: (successful.length / operationMetrics.length) * 100,
+            avgMemoryUsage: memoryUsages.reduce((a, b) => a + b, 0) / memoryUsages.length,
+        };
+    }
+    /**
+     * Benchmark a cryptographic operation
+     */
+    async benchmarkOperation(operationName, operation, iterations = 100, metadata) {
+        const results = [];
+        let successCount = 0;
+        let maxMemory = 0;
+        const recommendations = [];
+        console.log(`Starting benchmark for ${operationName} (${iterations} iterations)...`);
+        for (let i = 0; i < iterations; i++) {
+            const operationId = `benchmark_${operationName}_${i}`;
+            try {
+                this.startOperation(operationId, operationName, metadata);
+                await operation();
+                const metric = this.endOperation(operationId, true);
+                if (metric) {
+                    results.push(metric.duration || 0);
+                    successCount++;
+                    maxMemory = Math.max(maxMemory, metric.memoryUsage?.heapUsed || 0);
+                }
+            }
+            catch (error) {
+                this.endOperation(operationId, false, error.name);
+            }
+        }
+        const avgDuration = results.reduce((a, b) => a + b, 0) / results.length;
+        const minDuration = Math.min(...results);
+        const maxDuration = Math.max(...results);
+        const successRate = (successCount / iterations) * 100;
+        // Generate performance recommendations
+        if (avgDuration > 1000) {
+            recommendations.push("Operation is slow - consider optimizing algorithm or key size");
+        }
+        if (successRate < 95) {
+            recommendations.push("Low success rate detected - investigate error causes");
+        }
+        if (maxMemory > 100 * 1024 * 1024) {
+            // 100MB
+            recommendations.push("High memory usage detected - consider memory optimization");
+        }
+        if (metadata?.keySize && metadata.keySize > 4096) {
+            recommendations.push("Large key size may impact performance - consider if necessary");
+        }
+        const benchmark = {
+            operation: operationName,
+            algorithm: metadata?.algorithm || "unknown",
+            keySize: metadata?.keySize || 0,
+            dataSize: metadata?.dataSize || 0,
+            iterations,
+            avgDuration,
+            minDuration,
+            maxDuration,
+            successRate,
+            memoryPeak: maxMemory,
+            recommendations,
+        };
+        const benchmarkKey = `${operationName}_${metadata?.algorithm}_${metadata?.keySize}`;
+        this.benchmarks.set(benchmarkKey, benchmark);
+        return benchmark;
+    }
+    /**
+     * Get performance recommendations based on collected metrics
+     */
+    getPerformanceRecommendations() {
+        const recommendations = [];
+        const stats = new Map();
+        // Collect stats for each operation type
+        const operationTypes = [
+            ...new Set(this.metrics.map((m) => m.operationName)),
+        ];
+        for (const opType of operationTypes) {
+            stats.set(opType, this.getOperationStats(opType));
+        }
+        // Analyze and generate recommendations
+        for (const [operation, stat] of stats.entries()) {
+            if (stat.successRate < 95) {
+                recommendations.push(`${operation}: Low success rate (${stat.successRate.toFixed(1)}%) - investigate errors`);
+            }
+            if (stat.avgDuration > 1000) {
+                recommendations.push(`${operation}: Slow performance (${stat.avgDuration.toFixed(1)}ms avg) - consider optimization`);
+            }
+            if (stat.avgMemoryUsage > 50 * 1024 * 1024) {
+                // 50MB
+                recommendations.push(`${operation}: High memory usage (${(stat.avgMemoryUsage /
+                    1024 /
+                    1024).toFixed(1)}MB avg) - optimize memory usage`);
+            }
+        }
+        // General recommendations
+        if (this.metrics.length > 1000) {
+            recommendations.push("Large number of operations recorded - consider clearing old metrics");
+        }
+        return recommendations;
+    }
+    /**
+     * Clear old metrics to prevent memory leaks
+     */
+    clearOldMetrics(maxAge = 3600000) {
+        // 1 hour default
+        const cutoff = Date.now() - maxAge;
+        this.metrics = this.metrics.filter((metric) => {
+            const metricTime = Number(metric.startTime) / 1000000; // Convert to milliseconds
+            return metricTime > cutoff;
+        });
+    }
+    /**
+     * Export metrics for external analysis
+     */
+    exportMetrics() {
+        const summary = {};
+        const operationTypes = [
+            ...new Set(this.metrics.map((m) => m.operationName)),
+        ];
+        for (const opType of operationTypes) {
+            summary[opType] = this.getOperationStats(opType);
+        }
+        return {
+            metrics: this.metrics,
+            benchmarks: Array.from(this.benchmarks.values()),
+            summary,
+        };
+    }
+    /**
+     * Monitor system resources
+     */
+    getSystemResourceUsage() {
+        return {
+            memory: process.memoryUsage(),
+            cpu: process.cpuUsage(),
+            uptime: process.uptime(),
+            loadAverage: require("os").loadavg(),
+        };
+    }
+    /**
+     * Performance-aware operation wrapper
+     */
+    async monitoredOperation(operationName, operation, metadata) {
+        const operationId = `${operationName}_${Date.now()}_${Math.random()
+            .toString(36)
+            .substr(2, 9)}`;
+        try {
+            this.startOperation(operationId, operationName, metadata);
+            const result = await operation();
+            this.endOperation(operationId, true);
+            return result;
+        }
+        catch (error) {
+            this.endOperation(operationId, false, error.name);
+            throw error;
+        }
+    }
+}
+/**
+ * Global performance monitor instance
+ */
+const globalPerformanceMonitor = new CryptoPerformanceMonitor();
+
+export { CryptoPerformanceMonitor, globalPerformanceMonitor };
+//# sourceMappingURL=performanceMonitor.js.map

package/dist/esm/mods/security/src/utils/performanceMonitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performanceMonitor.js","sources":["../../../../../../mods/security/src/utils/performanceMonitor.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/mods/security/src/utils/stats.js

@@ -0,0 +1,180 @@
+/**
+ * Class for tracking cryptographic operation statistics
+ */
+class StatsTracker {
+    /**
+     * Get the singleton instance of StatsTracker
+     * @returns The StatsTracker instance
+     */
+    static getInstance() {
+        if (!StatsTracker.instance) {
+            StatsTracker.instance = new StatsTracker();
+        }
+        return StatsTracker.instance;
+    }
+    /**
+     * Private constructor to enforce singleton pattern
+     */
+    constructor() {
+        this.stats = {
+            tokensGenerated: 0,
+            hashesComputed: 0,
+            keysDerivated: 0,
+            averageEntropyBits: 0,
+            lastOperationTime: new Date().toISOString(),
+            performance: {
+                tokenGenerationAvgMs: 0,
+                hashComputationAvgMs: 0,
+                keyDerivationAvgMs: 0,
+            },
+            memory: {
+                peakUsageBytes: 0,
+                averageUsageBytes: 0,
+            },
+        };
+        this.tokenGenerationTimes = [];
+        this.hashComputationTimes = [];
+        this.keyDerivationTimes = [];
+        this.entropyMeasurements = [];
+        this.memoryMeasurements = [];
+        // Initialize memory tracking if in Node.js environment
+        if (typeof process !== "undefined" &&
+            typeof process.memoryUsage === "function") {
+            this.trackMemoryUsage();
+        }
+    }
+    /**
+     * Track token generation
+     * @param timeMs - Time taken to generate the token in milliseconds
+     * @param entropyBits - Estimated entropy bits of the token
+     */
+    trackTokenGeneration(timeMs, entropyBits) {
+        this.stats.tokensGenerated++;
+        this.tokenGenerationTimes.push(timeMs);
+        this.entropyMeasurements.push(entropyBits);
+        this.updateAverages();
+        this.updateLastOperationTime();
+    }
+    /**
+     * Track hash computation
+     * @param timeMs - Time taken to compute the hash in milliseconds
+     */
+    trackHashComputation(timeMs) {
+        this.stats.hashesComputed++;
+        this.hashComputationTimes.push(timeMs);
+        this.updateAverages();
+        this.updateLastOperationTime();
+    }
+    /**
+     * Track key derivation
+     * @param timeMs - Time taken to derive the key in milliseconds
+     * @param entropyBits - Estimated entropy bits of the key
+     */
+    trackKeyDerivation(timeMs, entropyBits) {
+        this.stats.keysDerivated++;
+        this.keyDerivationTimes.push(timeMs);
+        this.entropyMeasurements.push(entropyBits);
+        this.updateAverages();
+        this.updateLastOperationTime();
+    }
+    /**
+     * Get the current statistics
+     * @returns The current cryptographic statistics
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+    /**
+     * Reset all statistics
+     */
+    resetStats() {
+        this.stats = {
+            tokensGenerated: 0,
+            hashesComputed: 0,
+            keysDerivated: 0,
+            averageEntropyBits: 0,
+            lastOperationTime: new Date().toISOString(),
+            performance: {
+                tokenGenerationAvgMs: 0,
+                hashComputationAvgMs: 0,
+                keyDerivationAvgMs: 0,
+            },
+            memory: {
+                peakUsageBytes: 0,
+                averageUsageBytes: 0,
+            },
+        };
+        this.tokenGenerationTimes = [];
+        this.hashComputationTimes = [];
+        this.keyDerivationTimes = [];
+        this.entropyMeasurements = [];
+        this.memoryMeasurements = [];
+    }
+    /**
+     * Update average performance metrics
+     */
+    updateAverages() {
+        // Update token generation average
+        if (this.tokenGenerationTimes.length > 0) {
+            const sum = this.tokenGenerationTimes.reduce((a, b) => a + b, 0);
+            this.stats.performance.tokenGenerationAvgMs =
+                sum / this.tokenGenerationTimes.length;
+        }
+        // Update hash computation average
+        if (this.hashComputationTimes.length > 0) {
+            const sum = this.hashComputationTimes.reduce((a, b) => a + b, 0);
+            this.stats.performance.hashComputationAvgMs =
+                sum / this.hashComputationTimes.length;
+        }
+        // Update key derivation average
+        if (this.keyDerivationTimes.length > 0) {
+            const sum = this.keyDerivationTimes.reduce((a, b) => a + b, 0);
+            this.stats.performance.keyDerivationAvgMs =
+                sum / this.keyDerivationTimes.length;
+        }
+        // Update entropy average
+        if (this.entropyMeasurements.length > 0) {
+            const sum = this.entropyMeasurements.reduce((a, b) => a + b, 0);
+            this.stats.averageEntropyBits =
+                sum / this.entropyMeasurements.length;
+        }
+        // Update memory averages
+        if (this.memoryMeasurements.length > 0) {
+            const sum = this.memoryMeasurements.reduce((a, b) => a + b, 0);
+            this.stats.memory.averageUsageBytes =
+                sum / this.memoryMeasurements.length;
+        }
+    }
+    /**
+     * Update the last operation timestamp
+     */
+    updateLastOperationTime() {
+        this.stats.lastOperationTime = new Date().toISOString();
+    }
+    /**
+     * Track memory usage (Node.js only)
+     */
+    trackMemoryUsage() {
+        if (typeof process !== "undefined" &&
+            typeof process.memoryUsage === "function") {
+            // Check memory usage every 5 seconds
+            setInterval(() => {
+                const memoryUsage = process.memoryUsage();
+                const heapUsed = memoryUsage.heapUsed;
+                this.memoryMeasurements.push(heapUsed);
+                // Update peak memory usage
+                if (heapUsed > this.stats.memory.peakUsageBytes) {
+                    this.stats.memory.peakUsageBytes = heapUsed;
+                }
+                // Keep only the last 100 measurements
+                if (this.memoryMeasurements.length > 100) {
+                    this.memoryMeasurements.shift();
+                }
+                this.updateAverages();
+            }, 5000);
+        }
+    }
+}
+
+export { StatsTracker };
+//# sourceMappingURL=stats.js.map

package/dist/esm/mods/security/src/utils/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sources":["../../../../../../mods/security/src/utils/stats.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}