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

package/dist/matter/matterNetworkMonitor.js

@@ -0,0 +1,227 @@
+/* global NodeJS */
+/**
+ * Matter Network Monitor
+ *
+ * Monitors network connectivity and handles recovery
+ */
+import * as net from 'node:net';
+import * as os from 'node:os';
+import { Logger } from '../logger.js';
+import { errorHandler, MatterErrorType } from './matterErrorHandler.js';
+const log = Logger.withPrefix('Matter');
+export class MatterNetworkMonitor {
+    static instance;
+    status;
+    checkInterval = null;
+    callbacks = new Set();
+    checkIntervalMs = 30000; // Check every 30 seconds
+    isMonitoring = false;
+    stabilityCounter = 0;
+    STABILITY_THRESHOLD = 3;
+    constructor() {
+        this.status = {
+            isOnline: true,
+            interfaces: [],
+            lastCheck: new Date(),
+            consecutiveFailures: 0,
+        };
+    }
+    static getInstance() {
+        if (!MatterNetworkMonitor.instance) {
+            MatterNetworkMonitor.instance = new MatterNetworkMonitor();
+        }
+        return MatterNetworkMonitor.instance;
+    }
+    /**
+     * Start monitoring network connectivity
+     */
+    startMonitoring() {
+        if (this.isMonitoring) {
+            return;
+        }
+        this.isMonitoring = true;
+        log.debug('Starting Matter network monitoring');
+        // Initial check (fire-and-forget with error handling)
+        this.checkNetworkStatus().catch((error) => {
+            log.debug('Error during initial network check:', error);
+        });
+        // Set up periodic checks
+        this.checkInterval = setInterval(() => {
+            // Fire-and-forget with error handling
+            this.checkNetworkStatus().catch((error) => {
+                log.debug('Error during periodic network check:', error);
+            });
+        }, this.checkIntervalMs);
+        // Register recovery callback with error handler
+        errorHandler.registerRecoveryCallback(MatterErrorType.NETWORK, async () => this.handleNetworkRecovery());
+    }
+    /**
+     * Stop monitoring
+     */
+    stopMonitoring() {
+        if (this.checkInterval) {
+            clearInterval(this.checkInterval);
+            this.checkInterval = null;
+        }
+        this.isMonitoring = false;
+        log.debug('Stopped Matter network monitoring');
+    }
+    /**
+     * Check network status
+     */
+    async checkNetworkStatus() {
+        try {
+            // Get network interfaces
+            const interfaces = this.getActiveInterfaces();
+            // Test connectivity with a simple port check
+            const isOnline = await this.testConnectivity();
+            const previousStatus = this.status.isOnline;
+            this.status = {
+                isOnline,
+                interfaces: interfaces.map(i => i.name),
+                primaryInterface: interfaces[0]?.name,
+                lastCheck: new Date(),
+                consecutiveFailures: isOnline ? 0 : this.status.consecutiveFailures + 1,
+            };
+            // Notify listeners if status changed
+            if (previousStatus !== isOnline) {
+                this.notifyStatusChange();
+                if (!isOnline) {
+                    this.stabilityCounter = 0;
+                    log.warn('Matter network connectivity lost');
+                    await errorHandler.handleError(new Error('Network connectivity lost'), 'network-monitor');
+                }
+                else {
+                    this.stabilityCounter = 0;
+                    log.info('Matter network connectivity restored');
+                    errorHandler.resetErrorCount(MatterErrorType.NETWORK);
+                }
+            }
+            else if (isOnline) {
+                // Increment stability counter when consistently online
+                this.stabilityCounter = Math.min(this.stabilityCounter + 1, this.STABILITY_THRESHOLD);
+            }
+            // Log warnings for repeated failures
+            if (this.status.consecutiveFailures > 3) {
+                log.error(`Network has been offline for ${this.status.consecutiveFailures} consecutive checks`);
+            }
+        }
+        catch (error) {
+            log.debug('Error checking network status:', error);
+        }
+    }
+    /**
+     * Get active network interfaces
+     */
+    getActiveInterfaces() {
+        const interfaces = [];
+        const networkInterfaces = os.networkInterfaces();
+        for (const [name, addrs] of Object.entries(networkInterfaces)) {
+            if (!addrs) {
+                continue;
+            }
+            for (const addr of addrs) {
+                // Skip internal (loopback) and non-IPv4 addresses
+                if (!addr.internal && addr.family === 'IPv4') {
+                    interfaces.push({ name, address: addr.address });
+                }
+            }
+        }
+        return interfaces;
+    }
+    /**
+     * Test network connectivity with optimizations
+     */
+    async testConnectivity() {
+        // If we recently had a successful check, skip the test
+        const timeSinceLastCheck = Date.now() - (this.status.lastCheck?.getTime() || 0);
+        if (this.status.isOnline && timeSinceLastCheck < 5000 && this.stabilityCounter >= this.STABILITY_THRESHOLD) {
+            log.debug('Skipping connectivity test - recent successful check');
+            return true;
+        }
+        return new Promise((resolve) => {
+            const socket = new net.Socket();
+            const timeout = 2000; // Reduced timeout for faster failure detection
+            const cleanup = () => {
+                socket.destroy();
+            };
+            socket.setTimeout(timeout);
+            socket.once('connect', () => {
+                cleanup();
+                resolve(true);
+            });
+            socket.once('error', () => {
+                cleanup();
+                resolve(false);
+            });
+            socket.once('timeout', () => {
+                cleanup();
+                resolve(false);
+            });
+            // Try multiple fallback servers for redundancy
+            const servers = [
+                { host: '1.1.1.1', port: 53 }, // Cloudflare DNS
+                { host: '8.8.8.8', port: 53 }, // Google DNS
+                { host: '9.9.9.9', port: 53 }, // Quad9 DNS
+            ];
+            // Try first server, with fallback logic if needed
+            const server = servers[this.status.consecutiveFailures % servers.length];
+            socket.connect(server.port, server.host);
+        });
+    }
+    /**
+     * Handle network recovery
+     */
+    async handleNetworkRecovery() {
+        log.info('Attempting network recovery...');
+        // Force a network check
+        await this.checkNetworkStatus();
+        if (this.status.isOnline) {
+            log.info('Network is online, recovery successful');
+        }
+        else {
+            log.warn('Network still offline, will retry');
+            throw new Error('Network recovery failed');
+        }
+    }
+    /**
+     * Register a callback for network status changes
+     */
+    onStatusChange(callback) {
+        this.callbacks.add(callback);
+    }
+    /**
+     * Remove a status change callback
+     */
+    removeStatusChangeCallback(callback) {
+        this.callbacks.delete(callback);
+    }
+    /**
+     * Notify all listeners of status change
+     */
+    notifyStatusChange() {
+        for (const callback of this.callbacks) {
+            try {
+                callback(this.status);
+            }
+            catch (error) {
+                log.debug('Error in network status callback:', error);
+            }
+        }
+    }
+    /**
+     * Get current network status
+     */
+    getStatus() {
+        return { ...this.status };
+    }
+    /**
+     * Check if network is healthy
+     */
+    isHealthy() {
+        return this.status.isOnline && this.status.consecutiveFailures === 0;
+    }
+}
+// Export singleton instance
+export const networkMonitor = MatterNetworkMonitor.getInstance();
+//# sourceMappingURL=matterNetworkMonitor.js.map

package/dist/matter/matterNetworkMonitor.js.map

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

package/dist/matter/matterServer.d.ts

@@ -0,0 +1,196 @@
+/**
+ * Matter.js Server Implementation for Homebridge Plugin API
+ *
+ * This provides a Matter bridge that plugins can use to register
+ * Matter accessories via the Homebridge API.
+ */
+import { MatterServerConfig } from './matterSharedTypes.js';
+import { clusters, MatterAccessory } from './matterTypes.js';
+export { MatterServerConfig } from './matterSharedTypes.js';
+/**
+ * Matter Server for Homebridge Plugin API
+ * Allows plugins to register Matter accessories explicitly
+ */
+export declare class MatterServer {
+    private readonly config;
+    private serverNode;
+    private aggregator;
+    private accessories;
+    private isRunning;
+    private readonly MAX_DEVICES;
+    private shutdownHandler;
+    private passcode;
+    private discriminator;
+    private readonly vendorId;
+    private readonly productId;
+    private commissioningInfo;
+    private serialNumber?;
+    private cleanupHandlers;
+    private storageManager;
+    constructor(config?: MatterServerConfig);
+    /**
+     * Generate a secure random passcode
+     * According to Matter spec, passcode must be:
+     * - 8 digits (00000001 to 99999998)
+     * - Not in the invalid list
+     * - Not sequential or repeating patterns
+     */
+    private generateSecurePasscode;
+    /**
+     * Validate a passcode according to Matter specifications
+     */
+    private isValidPasscode;
+    /**
+     * Generate a random discriminator
+     * According to Matter spec, discriminator must be:
+     * - 12 bits (0-4095)
+     * - Should be random for security
+     */
+    private generateRandomDiscriminator;
+    /**
+     * Create ServerNode with automatic recovery from corrupted storage
+     * If ServerNode creation fails due to corrupted fabric data, automatically
+     * clean up the ServerNodeStore and retry once
+     */
+    private createServerNodeWithRecovery;
+    /**
+     * Start the Matter server
+     */
+    start(): Promise<void>;
+    /**
+     * Set up and validate storage
+     */
+    private setupStorage;
+    /**
+     * Load or generate commissioning credentials (passcode and discriminator)
+     * These must be persistent across restarts to maintain the same QR code
+     */
+    private loadOrGenerateCredentials;
+    /**
+     * Generate serial number for the bridge
+     */
+    private generateSerialNumber;
+    /**
+     * Generate and display commissioning information
+     */
+    private generateCommissioningInfo;
+    /**
+     * Wait for the server to be ready
+     */
+    private waitForServerReady;
+    /**
+     * Register a Matter accessory (Plugin API)
+     */
+    registerAccessory(accessory: MatterAccessory): Promise<void>;
+    /**
+     * Unregister a Matter accessory (Plugin API)
+     */
+    unregisterAccessory(uuid: string): Promise<void>;
+    /**
+     * Update a Matter accessory's state (Plugin API)
+     */
+    updateAccessoryState(uuid: string, cluster: string, attributes: Record<string, unknown>): Promise<void>;
+    /**
+     * Get all registered accessories (Plugin API)
+     */
+    getAccessories(): MatterAccessory[];
+    /**
+     * Get a specific accessory by UUID (Plugin API)
+     */
+    getAccessory(uuid: string): MatterAccessory | undefined;
+    /**
+     * Configure a Matter endpoint after it's been added to the aggregator
+     */
+    private configureEndpoint;
+    /**
+     * Stop the Matter server
+     */
+    stop(): Promise<void>;
+    /**
+     * Cleanup resources
+     */
+    private cleanup;
+    /**
+     * Get fabric information for commissioned controllers
+     */
+    getFabricInfo(): Array<{
+        fabricIndex: number;
+        fabricId: string;
+        nodeId: string;
+        rootVendorId: number;
+        label?: string;
+    }>;
+    /**
+     * Check if the server is commissioned
+     */
+    isCommissioned(): boolean;
+    /**
+     * Get the number of commissioned fabrics
+     */
+    getCommissionedFabricCount(): number;
+    /**
+     * Get server status information
+     */
+    getServerInfo(): {
+        running: boolean;
+        port: number;
+        deviceCount: number;
+        commissioned: boolean;
+        fabricCount: number;
+        serialNumber?: string;
+    };
+    /**
+     * Get commissioning information
+     */
+    getCommissioningInfo(): {
+        qrCode?: string;
+        manualPairingCode?: string;
+        serialNumber?: string;
+        passcode?: number;
+        discriminator?: number;
+        commissioned: boolean;
+    };
+    /**
+     * Get storage statistics
+     */
+    getStorageStats(): Array<{
+        entries: number;
+        namespace: string;
+        path: string;
+    }> | null;
+    /**
+     * Check if server is running
+     */
+    isServerRunning(): boolean;
+    /**
+     * Get Matter device types available for plugin use
+     */
+    getDeviceTypes(): {
+        readonly OnOffLight: import("@matter/node/devices").OnOffLightDevice;
+        readonly DimmableLight: import("@matter/node/devices").DimmableLightDevice;
+        readonly ColorTemperatureLight: import("@matter/node/devices").ColorTemperatureLightDevice;
+        readonly ExtendedColorLight: import("@matter/node/devices").ExtendedColorLightDevice;
+        readonly OnOffSwitch: import("@matter/node/devices").OnOffLightSwitchDevice;
+        readonly OnOffOutlet: import("@matter/node/devices").OnOffPlugInUnitDevice;
+        readonly DimmableOutlet: import("@matter/node/devices").DimmablePlugInUnitDevice;
+        readonly TemperatureSensor: import("@matter/node/devices").TemperatureSensorDevice;
+        readonly HumiditySensor: import("@matter/node/devices").HumiditySensorDevice;
+        readonly LightSensor: import("@matter/node/devices").LightSensorDevice;
+        readonly MotionSensor: import("@matter/node/devices").OccupancySensorDevice;
+        readonly ContactSensor: import("@matter/node/devices").ContactSensorDevice;
+        readonly LeakSensor: import("@matter/node/devices").WaterLeakDetectorDevice;
+        readonly SmokeSensor: import("@matter/node/devices").SmokeCoAlarmDevice;
+        readonly Thermostat: import("@matter/node/devices").ThermostatDevice;
+        readonly Fan: import("@matter/node/devices").FanDevice;
+        readonly DoorLock: import("@matter/node/devices").DoorLockDevice;
+        readonly WindowCovering: import("@matter/node/devices").WindowCoveringDevice;
+        readonly GenericSwitch: import("@matter/node/devices").GenericSwitchDevice;
+        readonly Pump: import("@matter/node/devices").PumpDevice;
+        readonly RoomAirConditioner: import("@matter/node/devices").RoomAirConditionerDevice;
+    };
+    /**
+     * Get Matter clusters available for plugin use
+     */
+    getClusters(): typeof clusters;
+}
+//# sourceMappingURL=matterServer.d.ts.map

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

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