homebridge 2.0.0-alpha.40 → 2.0.0-alpha.42

package/dist/matter/matterDiagnostics.js

@@ -0,0 +1,323 @@
+/* global NodeJS */
+/**
+ * Matter Diagnostics
+ *
+ * Comprehensive diagnostics and health monitoring for Matter integration
+ */
+import * as os from 'node:os';
+import process from 'node:process';
+import { Logger } from '../logger.js';
+import { errorHandler } from './matterErrorHandler.js';
+import { networkMonitor } from './matterNetworkMonitor.js';
+const log = Logger.withPrefix('Matter');
+export class MatterDiagnostics {
+    static instance;
+    performanceMetrics;
+    diagnosticInterval = null;
+    isDiagnosticsEnabled = false;
+    lastHealthStatus = null;
+    constructor() {
+        this.performanceMetrics = {
+            syncTimes: [],
+            startTime: new Date(),
+        };
+    }
+    static getInstance() {
+        if (!MatterDiagnostics.instance) {
+            MatterDiagnostics.instance = new MatterDiagnostics();
+        }
+        return MatterDiagnostics.instance;
+    }
+    /**
+     * Start diagnostics collection
+     */
+    startDiagnostics(intervalMs = 60000) {
+        if (this.isDiagnosticsEnabled) {
+            return;
+        }
+        this.isDiagnosticsEnabled = true;
+        log.debug('Starting Matter diagnostics collection');
+        // Collect diagnostics periodically
+        this.diagnosticInterval = setInterval(() => {
+            // Fire-and-forget with error handling
+            this.collectAndLogDiagnostics().catch((error) => {
+                log.debug('Failed to collect diagnostics:', error);
+            });
+        }, intervalMs);
+    }
+    /**
+     * Stop diagnostics collection
+     */
+    stopDiagnostics() {
+        if (this.diagnosticInterval) {
+            clearInterval(this.diagnosticInterval);
+            this.diagnosticInterval = null;
+        }
+        this.isDiagnosticsEnabled = false;
+        log.debug('Stopped Matter diagnostics collection');
+    }
+    /**
+     * Record sync performance
+     */
+    recordSyncTime(timeMs) {
+        this.performanceMetrics.syncTimes.push(timeMs);
+        // Keep only last 100 measurements
+        if (this.performanceMetrics.syncTimes.length > 100) {
+            this.performanceMetrics.syncTimes.shift();
+        }
+        // Log warning for slow syncs
+        if (timeMs > 1000) {
+            log.warn(`Slow Matter sync detected: ${timeMs}ms`);
+        }
+    }
+    /**
+     * Collect all diagnostic information
+     */
+    async collectDiagnostics(matterInfo) {
+        return {
+            timestamp: new Date(),
+            system: this.collectSystemInfo(),
+            matter: matterInfo || this.getDefaultMatterInfo(),
+            network: this.collectNetworkInfo(),
+            errors: this.collectErrorInfo(),
+            performance: this.collectPerformanceInfo(),
+            health: this.assessHealth(),
+        };
+    }
+    /**
+     * Collect system information
+     */
+    collectSystemInfo() {
+        const totalMem = os.totalmem();
+        const freeMem = os.freemem();
+        const usedMem = totalMem - freeMem;
+        const cpus = os.cpus();
+        const avgLoad = os.loadavg()[0];
+        return {
+            platform: os.platform(),
+            arch: os.arch(),
+            nodeVersion: process.version,
+            uptime: os.uptime(),
+            memory: {
+                total: totalMem,
+                free: freeMem,
+                used: usedMem,
+                percentage: (usedMem / totalMem) * 100,
+            },
+            cpu: {
+                model: cpus[0]?.model || 'Unknown',
+                cores: cpus.length,
+                usage: avgLoad,
+            },
+        };
+    }
+    /**
+     * Get default Matter info
+     */
+    getDefaultMatterInfo() {
+        return {
+            enabled: false,
+            initialized: false,
+            running: false,
+            deviceCount: 0,
+            bridgeCount: 0,
+        };
+    }
+    /**
+     * Collect network information
+     */
+    collectNetworkInfo() {
+        const status = networkMonitor.getStatus();
+        return {
+            online: status.isOnline,
+            interfaces: status.interfaces,
+            primaryInterface: status.primaryInterface,
+            lastCheck: status.lastCheck,
+        };
+    }
+    /**
+     * Collect error information
+     */
+    collectErrorInfo() {
+        const errorStats = errorHandler.getErrorStats();
+        let total = 0;
+        const byType = {};
+        const recent = [];
+        for (const [type, stats] of Object.entries(errorStats)) {
+            total += stats.count;
+            byType[type] = stats.count;
+            if (stats.lastError) {
+                recent.push({
+                    type,
+                    message: stats.lastError.message,
+                    timestamp: stats.lastError.timestamp,
+                });
+            }
+        }
+        // Sort recent errors by timestamp
+        recent.sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime());
+        return {
+            total,
+            byType,
+            recent: recent.slice(0, 10), // Keep only 10 most recent
+        };
+    }
+    /**
+     * Collect performance information
+     */
+    collectPerformanceInfo() {
+        const syncTimes = this.performanceMetrics.syncTimes;
+        const avgSyncTime = syncTimes.length > 0
+            ? syncTimes.reduce((a, b) => a + b, 0) / syncTimes.length
+            : 0;
+        return {
+            syncLatency: syncTimes.slice(-10), // Last 10 measurements
+            averageSyncTime: avgSyncTime,
+            memoryUsage: process.memoryUsage().heapUsed,
+            eventLoopLag: 0, // Would need additional monitoring
+        };
+    }
+    /**
+     * Assess overall health
+     */
+    assessHealth() {
+        const issues = [];
+        const recommendations = [];
+        // Check network
+        const networkStatus = networkMonitor.getStatus();
+        if (!networkStatus.isOnline) {
+            issues.push('Network is offline');
+            recommendations.push('Check network connectivity');
+        }
+        else if (networkStatus.consecutiveFailures > 0) {
+            issues.push('Intermittent network issues detected');
+            recommendations.push('Monitor network stability');
+        }
+        // Check errors
+        const errorStats = errorHandler.getErrorStats();
+        const totalErrors = Object.values(errorStats)
+            .reduce((sum, stat) => sum + stat.count, 0);
+        if (totalErrors > 10) {
+            issues.push(`High error rate: ${totalErrors} errors`);
+            recommendations.push('Review error logs for patterns');
+        }
+        // Check performance
+        const perfInfo = this.collectPerformanceInfo();
+        if (perfInfo.averageSyncTime > 500) {
+            issues.push(`Slow sync performance: ${perfInfo.averageSyncTime.toFixed(0)}ms average`);
+            recommendations.push('Consider reducing device count or optimizing sync frequency');
+        }
+        // Check memory (raised threshold to 95% to reduce false positives)
+        const systemInfo = this.collectSystemInfo();
+        if (systemInfo.memory.percentage > 95) {
+            issues.push(`High memory usage: ${systemInfo.memory.percentage.toFixed(1)}%`);
+            recommendations.push('Consider increasing system memory or reducing load');
+        }
+        else if (systemInfo.memory.percentage > 90) {
+            // Only log in debug mode for 90-95% range
+            log.debug(`Memory usage at ${systemInfo.memory.percentage.toFixed(1)}%`);
+        }
+        // Determine overall health
+        let overall;
+        if (issues.length === 0) {
+            overall = 'healthy';
+        }
+        else if (issues.length <= 2) {
+            overall = 'degraded';
+        }
+        else {
+            overall = 'unhealthy';
+        }
+        return {
+            overall,
+            issues,
+            recommendations,
+        };
+    }
+    /**
+     * Collect and log diagnostics
+     */
+    async collectAndLogDiagnostics() {
+        const diagnostics = await this.collectDiagnostics();
+        // Only log health status if it changed or is unhealthy
+        if (diagnostics.health.overall !== this.lastHealthStatus) {
+            this.lastHealthStatus = diagnostics.health.overall;
+            if (diagnostics.health.overall !== 'healthy') {
+                log.warn(`Matter health status: ${diagnostics.health.overall}`);
+                for (const issue of diagnostics.health.issues) {
+                    log.warn(`  - ${issue}`);
+                }
+                for (const recommendation of diagnostics.health.recommendations) {
+                    log.info(`  💡 ${recommendation}`);
+                }
+            }
+            else {
+                log.info('Matter health status: healthy');
+            }
+        }
+        // Log debug information
+        log.debug('Matter diagnostics:', {
+            health: diagnostics.health.overall,
+            errors: diagnostics.errors.total,
+            devices: diagnostics.matter.deviceCount,
+            avgSyncTime: `${diagnostics.performance.averageSyncTime.toFixed(0)}ms`,
+            memory: `${(diagnostics.system.memory.percentage).toFixed(1)}%`,
+        });
+    }
+    /**
+     * Generate diagnostic report
+     */
+    async generateReport(matterInfo) {
+        const diagnostics = await this.collectDiagnostics(matterInfo);
+        return `
+Matter Diagnostics Report
+========================
+Generated: ${diagnostics.timestamp.toISOString()}
+
+System Information
+------------------
+Platform: ${diagnostics.system.platform} (${diagnostics.system.arch})
+Node Version: ${diagnostics.system.nodeVersion}
+System Uptime: ${(diagnostics.system.uptime / 3600).toFixed(1)} hours
+Memory: ${(diagnostics.system.memory.used / 1024 / 1024 / 1024).toFixed(1)}GB / ${(diagnostics.system.memory.total / 1024 / 1024 / 1024).toFixed(1)}GB (${diagnostics.system.memory.percentage.toFixed(1)}%)
+CPU: ${diagnostics.system.cpu.model} (${diagnostics.system.cpu.cores} cores)
+
+Matter Status
+-------------
+Enabled: ${diagnostics.matter.enabled}
+Initialized: ${diagnostics.matter.initialized}
+Running: ${diagnostics.matter.running}
+Port: ${diagnostics.matter.port || 'N/A'}
+Devices: ${diagnostics.matter.deviceCount}
+Bridges: ${diagnostics.matter.bridgeCount}
+
+Network Status
+--------------
+Online: ${diagnostics.network.online}
+Interfaces: ${diagnostics.network.interfaces.join(', ') || 'None'}
+Primary: ${diagnostics.network.primaryInterface || 'N/A'}
+Last Check: ${diagnostics.network.lastCheck.toISOString()}
+
+Error Summary
+-------------
+Total Errors: ${diagnostics.errors.total}
+${Object.entries(diagnostics.errors.byType)
+            .map(([type, count]) => `  ${type}: ${count}`)
+            .join('\n')}
+
+Performance
+-----------
+Average Sync Time: ${diagnostics.performance.averageSyncTime.toFixed(0)}ms
+Memory Usage: ${(diagnostics.performance.memoryUsage / 1024 / 1024).toFixed(1)}MB
+
+Health Assessment
+-----------------
+Overall: ${diagnostics.health.overall.toUpperCase()}
+${diagnostics.health.issues.length > 0 ? `Issues:\n${diagnostics.health.issues.map(i => `  - ${i}`).join('\n')}` : ''}
+${diagnostics.health.recommendations.length > 0 ? `Recommendations:\n${diagnostics.health.recommendations.map(r => `  - ${r}`).join('\n')}` : ''}
+`;
+    }
+}
+// Export singleton instance
+export const diagnostics = MatterDiagnostics.getInstance();
+//# sourceMappingURL=matterDiagnostics.js.map

package/dist/matter/matterDiagnostics.js.map

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

package/dist/matter/matterErrorHandler.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Matter Error Handler
+ *
+ * Centralized error handling and recovery for Matter.js integration
+ * with circuit breaker pattern and contextual recovery
+ */
+import { MatterCommissioningError, MatterDeviceError, MatterError, MatterErrorType, MatterNetworkError, MatterStorageError } from './matterTypes.js';
+export { MatterCommissioningError, MatterDeviceError, MatterError, MatterErrorType, MatterNetworkError, MatterStorageError };
+/**
+ * Circuit breaker states
+ */
+declare enum CircuitState {
+    CLOSED = "CLOSED",// Normal operation
+    OPEN = "OPEN",// Failure threshold exceeded, blocking requests
+    HALF_OPEN = "HALF_OPEN"
+}
+export declare class MatterErrorHandler {
+    private static instance;
+    private errorCount;
+    private lastErrors;
+    private recoveryCallbacks;
+    private circuitBreakers;
+    private recoveryContexts;
+    private readonly MAX_RECOVERY_ATTEMPTS;
+    private constructor();
+    static getInstance(): MatterErrorHandler;
+    /**
+     * Handle a Matter error with context-aware recovery
+     */
+    handleError(error: Error | MatterError, context?: string): Promise<void>;
+    /**
+     * Categorize error into Matter error types
+     */
+    private categorizeError;
+    /**
+     * Log error with appropriate severity
+     */
+    private logError;
+    /**
+     * Get error type from MatterError
+     */
+    private getErrorType;
+    /**
+     * Track error occurrences with bounds checking
+     */
+    private trackError;
+    /**
+     * Clear errors for a specific type
+     */
+    private clearErrors;
+    /**
+     * Attempt contextual recovery from error
+     */
+    private attemptContextualRecovery;
+    /**
+     * Get or create a circuit breaker for an error type
+     */
+    private getOrCreateCircuitBreaker;
+    /**
+     * Check if we should attempt recovery
+     */
+    private shouldAttemptRecovery;
+    /**
+     * Get contextual delay based on error type and attempt count
+     */
+    private getContextualDelay;
+    /**
+     * Register a recovery callback for specific error type
+     */
+    registerRecoveryCallback(type: MatterErrorType, callback: () => Promise<void>): void;
+    /**
+     * Reset error counts (useful after successful recovery)
+     */
+    resetErrorCount(type?: MatterErrorType): void;
+    /**
+     * Get error statistics
+     */
+    getErrorStats(): Map<MatterErrorType, {
+        count: number;
+        lastError?: MatterError;
+        circuitState?: CircuitState;
+        recoveryAttempts?: number;
+    }>;
+    /**
+     * Create a wrapped function with error handling
+     */
+    wrapAsync<T extends (...args: any[]) => Promise<any>>(fn: T, context: string): T;
+    /**
+     * Create a wrapped function with error suppression
+     */
+    wrapAsyncSafe<T extends (...args: any[]) => Promise<any>>(fn: T, context: string, defaultValue?: ReturnType<T>): T;
+}
+export declare const errorHandler: MatterErrorHandler;
+//# sourceMappingURL=matterErrorHandler.d.ts.map

package/dist/matter/matterErrorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matterErrorHandler.d.ts","sourceRoot":"","sources":["../../src/matter/matterErrorHandler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,kBAAkB,CAAA;AAKzB,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,CAAA;AAE5H;;GAEG;AACH,aAAK,YAAY;IACf,MAAM,WAAW,CAAE,mBAAmB;IACtC,IAAI,SAAS,CAAE,gDAAgD;IAC/D,SAAS,cAAc;CACxB;AAqGD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAoB;IAC3C,OAAO,CAAC,UAAU,CAAqC;IACvD,OAAO,CAAC,UAAU,CAA0C;IAC5D,OAAO,CAAC,iBAAiB,CAAsD;IAC/E,OAAO,CAAC,eAAe,CAA6C;IACpE,OAAO,CAAC,gBAAgB,CAA8C;IACtE,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAI;IAE1C,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,kBAAkB;IAOxC;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB9E;;OAEG;IACH,OAAO,CAAC,eAAe;IA2DvB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAuChB;;OAEG;IACH,OAAO,CAAC,YAAY;IAoBpB;;OAEG;IACH,OAAO,CAAC,UAAU;IAiClB;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;YACW,yBAAyB;IAyDvC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IASjC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAW7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;IACH,wBAAwB,CAAC,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAMpF;;OAEG;IACH,eAAe,CAAC,IAAI,CAAC,EAAE,eAAe,GAAG,IAAI;IAuB7C;;OAEG;IACH,aAAa,IAAI,GAAG,CAAC,eAAe,EAAE;QACpC,KAAK,EAAE,MAAM,CAAA;QACb,SAAS,CAAC,EAAE,WAAW,CAAA;QACvB,YAAY,CAAC,EAAE,YAAY,CAAA;QAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAC1B,CAAC;IAmBF;;OAEG;IACH,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EAClD,EAAE,EAAE,CAAC,EACL,OAAO,EAAE,MAAM,GACd,CAAC;IAWJ;;OAEG;IACH,aAAa,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EACtD,EAAE,EAAE,CAAC,EACL,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,GAC3B,CAAC;CAUL;AAGD,eAAO,MAAM,YAAY,oBAAmC,CAAA"}