homebridge 2.0.0-alpha.5 → 2.0.0-alpha.50

package/dist/matter/matterNetworkMonitor.d.ts

@@ -0,0 +1,68 @@
+export interface NetworkStatus {
+    isOnline: boolean;
+    interfaces: string[];
+    primaryInterface?: string;
+    lastCheck: Date;
+    consecutiveFailures: number;
+}
+export declare class MatterNetworkMonitor {
+    private static instance;
+    private status;
+    private checkInterval;
+    private callbacks;
+    private checkIntervalMs;
+    private isMonitoring;
+    private stabilityCounter;
+    private readonly STABILITY_THRESHOLD;
+    private constructor();
+    static getInstance(): MatterNetworkMonitor;
+    /**
+     * Start monitoring network connectivity
+     */
+    startMonitoring(): void;
+    /**
+     * Stop monitoring
+     */
+    stopMonitoring(): void;
+    /**
+     * Check network status
+     */
+    private checkNetworkStatus;
+    /**
+     * Get active network interfaces
+     */
+    private getActiveInterfaces;
+    /**
+     * Test network connectivity with optimizations
+     *
+     * Races multiple DNS servers to return as soon as any succeeds,
+     * providing faster connectivity checks and better redundancy.
+     */
+    private testConnectivity;
+    /**
+     * Handle network recovery
+     */
+    private handleNetworkRecovery;
+    /**
+     * Register a callback for network status changes
+     */
+    onStatusChange(callback: (status: NetworkStatus) => void): void;
+    /**
+     * Remove a status change callback
+     */
+    removeStatusChangeCallback(callback: (status: NetworkStatus) => void): void;
+    /**
+     * Notify all listeners of status change
+     */
+    private notifyStatusChange;
+    /**
+     * Get current network status
+     */
+    getStatus(): NetworkStatus;
+    /**
+     * Check if network is healthy
+     */
+    isHealthy(): boolean;
+}
+export declare const networkMonitor: MatterNetworkMonitor;
+//# sourceMappingURL=matterNetworkMonitor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"matterNetworkMonitor.d.ts","sourceRoot":"","sources":["../../src/matter/matterNetworkMonitor.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,CAAA;IACjB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,SAAS,EAAE,IAAI,CAAA;IACf,mBAAmB,EAAE,MAAM,CAAA;CAC5B;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAsB;IAC7C,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,SAAS,CAAkD;IACnE,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,gBAAgB,CAAI;IAC5B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAI;IAExC,OAAO;IASP,MAAM,CAAC,WAAW,IAAI,oBAAoB;IAO1C;;OAEG;IACH,eAAe,IAAI,IAAI;IA4BvB;;OAEG;IACH,cAAc,IAAI,IAAI;IAStB;;OAEG;YACW,kBAAkB;IAgDhC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;;;;OAKG;YACW,gBAAgB;IAiE9B;;OAEG;YACW,qBAAqB;IAcnC;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI;IAI/D;;OAEG;IACH,0BAA0B,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI;IAI3E;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;IACH,SAAS,IAAI,aAAa;IAI1B;;OAEG;IACH,SAAS,IAAI,OAAO;CAGrB;AAGD,eAAO,MAAM,cAAc,sBAAqC,CAAA"}

package/dist/matter/matterNetworkMonitor.js

@@ -0,0 +1,250 @@
+/* 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/Network');
+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
+     *
+     * Races multiple DNS servers to return as soon as any succeeds,
+     * providing faster connectivity checks and better redundancy.
+     */
+    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;
+        }
+        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
+        ];
+        // Test a single server
+        const testServer = (server) => {
+            return new Promise((resolve) => {
+                const socket = new net.Socket();
+                const timeout = 2000;
+                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);
+                });
+                socket.connect(server.port, server.host);
+            });
+        };
+        // Race all servers - return true as soon as ANY succeeds
+        try {
+            const racePromises = servers.map(async (server) => {
+                const success = await testServer(server);
+                if (success) {
+                    // If this server succeeded, return true immediately
+                    return { success: true };
+                }
+                // Otherwise, never resolve (let other promises continue racing)
+                return new Promise(() => { });
+            });
+            // Add a timeout promise to ensure we don't wait forever
+            const timeoutPromise = new Promise((resolve) => {
+                setTimeout(() => resolve({ success: false }), 3000);
+            });
+            const result = await Promise.race([...racePromises, timeoutPromise]);
+            return result.success;
+        }
+        catch (error) {
+            log.debug('Error during connectivity test:', error);
+            return false;
+        }
+    }
+    /**
+     * 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,283 @@
+/**
+ * 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 type { SerializedMatterAccessory } from './matterAccessoryCache.js';
+import { EventEmitter } from 'node:events';
+import { MatterServerConfig } from './matterSharedTypes.js';
+import { clusters, MatterAccessory, MatterServerEvents } from './matterTypes.js';
+export { MatterServerConfig } from './matterSharedTypes.js';
+/**
+ * Matter Server for Homebridge Plugin API
+ * Allows plugins to register Matter accessories explicitly
+ *
+ * Extends EventEmitter to provide commissioning lifecycle events
+ */
+export declare class MatterServer extends EventEmitter {
+    on: <K extends keyof MatterServerEvents>(event: K, listener: MatterServerEvents[K]) => this;
+    emit: <K extends keyof MatterServerEvents>(event: K, ...args: Parameters<MatterServerEvents[K]>) => boolean;
+    removeListener: <K extends keyof MatterServerEvents>(event: K, listener: MatterServerEvents[K]) => this;
+    removeAllListeners: (event?: keyof MatterServerEvents) => this;
+    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;
+    private matterStoragePath?;
+    private accessoryCache;
+    private fabricMonitorInterval;
+    private previousFabrics;
+    constructor(config: MatterServerConfig);
+    /**
+     * Validate and sanitize Matter server configuration
+     * Throws descriptive errors if configuration is invalid
+     */
+    private validateAndSanitizeConfig;
+    /**
+     * 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
+     *
+     * Matter.js can fail to start if fabric data is corrupted (common after
+     * hard shutdowns or disk errors). This method implements automatic recovery by:
+     *
+     * 1. Attempting normal ServerNode creation
+     * 2. If it fails with storage errors, identifying and removing corrupted files
+     * 3. Retrying ServerNode creation with fresh storage
+     *
+     * This prevents the need for manual intervention while preserving data
+     * safety by only removing storage on confirmed corruption errors.
+     *
+     * @param nodeOptions - Matter.js ServerNode configuration
+     * @param sanitizedId - Filesystem-safe bridge identifier
+     * @returns Initialized ServerNode instance
+     * @throws Error if recovery fails or error is not storage-related
+     */
+    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 and display commissioning information
+     */
+    private generateCommissioningInfo;
+    /**
+     * Wait for the server to be ready
+     */
+    private waitForServerReady;
+    /**
+     * Start monitoring fabric changes to emit commissioning events
+     */
+    private startFabricMonitoring;
+    /**
+     * Stop fabric monitoring
+     */
+    private stopFabricMonitoring;
+    /**
+     * Check for fabric changes and emit appropriate events
+     */
+    private checkFabricChanges;
+    /**
+     * Update commissioning info file when commissioning state changes
+     */
+    private updateCommissioningFile;
+    /**
+     * Register Matter platform accessories (Plugin API - matches HAP pattern)
+     */
+    registerPlatformAccessories(pluginIdentifier: string, platformName: string, accessories: MatterAccessory[]): Promise<void>;
+    /**
+     * Unregister Matter platform accessories (Plugin API - matches HAP pattern)
+     */
+    unregisterPlatformAccessories(pluginIdentifier: string, platformName: string, accessories: MatterAccessory[]): Promise<void>;
+    /**
+     * Register a single Matter accessory (internal method)
+     */
+    private registerAccessory;
+    /**
+     * Unregister a Matter accessory (Plugin API)
+     */
+    unregisterAccessory(uuid: string): Promise<void>;
+    /**
+     * Update a Matter accessory's state (Plugin API)
+     *
+     * This method can be called from anywhere, including from within handlers.
+     * State updates are automatically deferred to avoid transaction conflicts.
+     */
+    updateAccessoryState(uuid: string, cluster: string, attributes: Record<string, unknown>): Promise<void>;
+    /**
+     * Get a Matter accessory's current state (Plugin API)
+     *
+     * Returns the current cluster attribute values that are exposed to Matter controllers.
+     * This is useful for:
+     * - Reading state after plugin restart (when local variables are lost)
+     * - Verifying current state before making changes
+     * - Multiple parts of code that need to read state
+     * - Debugging and logging
+     *
+     * @param uuid - The UUID of the accessory
+     * @param cluster - The cluster name (e.g., 'onOff', 'levelControl')
+     * @returns Current cluster attribute values, or undefined if cluster not found
+     */
+    getAccessoryState(uuid: string, cluster: string): Record<string, unknown> | undefined;
+    /**
+     * Get all cached accessories (Internal - for restore process)
+     * @internal
+     */
+    getAllCachedAccessories(): SerializedMatterAccessory[];
+    /**
+     * Get all registered accessories (Plugin API)
+     */
+    getAccessories(): MatterAccessory[];
+    /**
+     * Get a specific accessory by UUID (Plugin API)
+     */
+    getAccessory(uuid: string): MatterAccessory | undefined;
+    /**
+     * 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;
+    /**
+     * Remove a specific fabric (controller) from the bridge
+     * This decommissions a single controller while leaving others intact
+     *
+     * @param fabricIndex - The fabric index to remove
+     * @returns Promise that resolves when the fabric is removed
+     */
+    removeFabric(fabricIndex: number): Promise<void>;
+    /**
+     * Check if a specific fabric exists
+     */
+    hasFabric(fabricIndex: number): boolean;
+    /**
+     * Notify controllers that the parts list has changed
+     * This triggers controllers (like Home app) to re-read the device list
+     * and discover new or removed accessories without needing to re-pair
+     */
+    private notifyPartsListChanged;
+}
+//# 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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"}