homebridge 2.0.0-alpha.4 → 2.0.0-alpha.40

package/dist/matterConfigValidator.js

@@ -0,0 +1,249 @@
+import { Logger } from './logger.js';
+const log = Logger.internal;
+/**
+ * Validate Matter configuration for production readiness
+ */
+export class MatterConfigValidator {
+    /**
+     * Validate a Matter configuration object
+     */
+    static validate(config) {
+        const result = {
+            isValid: true,
+            errors: [],
+            warnings: [],
+        };
+        if (!config.enabled) {
+            // No validation needed if Matter is disabled
+            return result;
+        }
+        // Validate required fields
+        this.validateRequired(config, result);
+        // Validate port configuration
+        this.validatePort(config, result);
+        // Validate discriminator
+        this.validateDiscriminator(config, result);
+        // Validate passcode
+        this.validatePasscode(config, result);
+        // Validate vendor and product IDs
+        this.validateVendorProductIds(config, result);
+        // Validate device name
+        this.validateDeviceName(config, result);
+        // Validate timeout values
+        this.validateTimeouts(config, result);
+        // Check for production readiness
+        this.checkProductionReadiness(config, result);
+        result.isValid = result.errors.length === 0;
+        if (result.warnings.length > 0) {
+            log.warn('Matter configuration warnings:');
+            result.warnings.forEach(warning => log.warn(`  - ${warning}`));
+        }
+        if (result.errors.length > 0) {
+            log.error('Matter configuration errors:');
+            result.errors.forEach(error => log.error(`  - ${error}`));
+        }
+        return result;
+    }
+    static validateRequired(config, result) {
+        const requiredFields = ['port', 'discriminator', 'passcode', 'vendorId', 'productId', 'deviceName'];
+        for (const field of requiredFields) {
+            if (config[field] === undefined || config[field] === null) {
+                result.errors.push(`Missing required field: ${field}`);
+            }
+        }
+    }
+    static validatePort(config, result) {
+        const port = config.port;
+        if (port !== undefined) {
+            if (!Number.isInteger(port) || port < 1024 || port > 65535) {
+                result.errors.push(`Port ${port} is invalid. Must be an integer between 1024-65535.`);
+            }
+            // Check for common conflicts
+            const conflictPorts = [5353, 8080, 8443]; // mDNS, common HTTP ports
+            if (conflictPorts.includes(port)) {
+                result.warnings.push(`Port ${port} may conflict with other services. Consider using a different port.`);
+            }
+        }
+    }
+    static validateDiscriminator(config, result) {
+        const discriminator = config.discriminator;
+        if (discriminator !== undefined) {
+            if (!Number.isInteger(discriminator) || discriminator < 0 || discriminator > 4095) {
+                result.errors.push(`Discriminator ${discriminator} is invalid. Must be an integer between 0-4095.`);
+            }
+        }
+    }
+    static validatePasscode(config, result) {
+        const passcode = config.passcode;
+        if (passcode !== undefined) {
+            const passcodeStr = passcode.toString();
+            // Check length
+            if (passcodeStr.length !== 8) {
+                result.errors.push(`Passcode ${passcode} is invalid. Must be exactly 8 digits.`);
+                return;
+            }
+            // Check if all digits
+            if (!/^\d{8}$/.test(passcodeStr)) {
+                result.errors.push(`Passcode ${passcode} is invalid. Must contain only digits.`);
+                return;
+            }
+            // Check for invalid patterns
+            const invalidPasscodes = [
+                '00000000',
+                '11111111',
+                '22222222',
+                '33333333',
+                '44444444',
+                '55555555',
+                '66666666',
+                '77777777',
+                '88888888',
+                '99999999',
+                '12345678',
+                '87654321',
+                '01234567',
+                '76543210',
+            ];
+            if (invalidPasscodes.includes(passcodeStr)) {
+                result.errors.push(`Passcode ${passcode} is not allowed. Use a more secure, non-sequential passcode.`);
+                return;
+            }
+            // Check for repeating patterns
+            if (this.hasRepeatingPattern(passcodeStr)) {
+                result.warnings.push(`Passcode ${passcode} has repeating patterns. Consider using a more random passcode.`);
+            }
+            // Check for common weak patterns
+            if (this.isWeakPasscode(passcodeStr)) {
+                result.errors.push(`Passcode ${passcode} is too weak. Use a more secure passcode.`);
+            }
+        }
+    }
+    static validateVendorProductIds(config, result) {
+        const vendorId = config.vendorId;
+        const productId = config.productId;
+        if (vendorId !== undefined) {
+            if (!Number.isInteger(vendorId) || vendorId < 0 || vendorId > 0xFFFF) {
+                result.errors.push(`Vendor ID ${vendorId} is invalid. Must be an integer between 0-65535.`);
+            }
+            // Check for test vendor IDs in production
+            const testVendorIds = [0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4];
+            if (testVendorIds.includes(vendorId)) {
+                result.warnings.push(`Using test vendor ID ${vendorId}. This should not be used in production.`);
+            }
+        }
+        if (productId !== undefined) {
+            if (!Number.isInteger(productId) || productId < 0 || productId > 0xFFFF) {
+                result.errors.push(`Product ID ${productId} is invalid. Must be an integer between 0-65535.`);
+            }
+        }
+    }
+    static validateDeviceName(config, result) {
+        const deviceName = config.deviceName;
+        if (deviceName !== undefined) {
+            if (typeof deviceName !== 'string') {
+                result.errors.push('Device name must be a string.');
+                return;
+            }
+            if (deviceName.length === 0) {
+                result.errors.push('Device name cannot be empty.');
+                return;
+            }
+            if (deviceName.length > 32) {
+                result.errors.push(`Device name "${deviceName}" is too long. Must be 32 characters or less.`);
+            }
+            // Check for invalid characters
+            if (!/^[\x20-\x7E]*$/.test(deviceName)) {
+                result.errors.push(`Device name "${deviceName}" contains invalid characters. Use only printable ASCII characters.`);
+            }
+        }
+    }
+    static validateTimeouts(config, result) {
+        const announceInterval = config.announceInterval;
+        const commissioningTimeout = config.commissioningTimeout;
+        if (announceInterval !== undefined) {
+            if (!Number.isInteger(announceInterval) || announceInterval < 1 || announceInterval > 3600) {
+                result.errors.push(`Announce interval ${announceInterval} is invalid. Must be between 1-3600 seconds.`);
+            }
+        }
+        if (commissioningTimeout !== undefined) {
+            if (!Number.isInteger(commissioningTimeout) || commissioningTimeout < 60 || commissioningTimeout > 7200) {
+                result.errors.push(`Commissioning timeout ${commissioningTimeout} is invalid. Must be between 60-7200 seconds.`);
+            }
+        }
+    }
+    static checkProductionReadiness(config, result) {
+        // Check for default/example values that shouldn't be used in production
+        if (config.passcode === 20202021) {
+            result.warnings.push('Using default passcode. Change this for production deployment.');
+        }
+        if (config.discriminator === 3840) {
+            result.warnings.push('Using default discriminator. Consider changing this for production deployment.');
+        }
+        if (config.deviceName === 'Homebridge Matter Bridge') {
+            result.warnings.push('Using default device name. Consider customizing for your deployment.');
+        }
+        // Check storage configuration
+        if (!config.storageDir || config.storageDir === './persist') {
+            result.warnings.push('Using default storage directory. Ensure this directory is persistent and backed up.');
+        }
+        // Check debug settings
+        if (config.debugEnabled) {
+            result.warnings.push('Debug mode is enabled. Disable this in production for better performance.');
+        }
+    }
+    static hasRepeatingPattern(passcode) {
+        // Check for simple repeating patterns like "1212" or "123123"
+        for (let len = 2; len <= 4; len++) {
+            const pattern = passcode.substring(0, len);
+            const repeated = pattern.repeat(Math.ceil(8 / len)).substring(0, 8);
+            if (passcode === repeated) {
+                return true;
+            }
+        }
+        return false;
+    }
+    static isWeakPasscode(passcode) {
+        // Check for ascending/descending sequences
+        let ascending = 0;
+        let descending = 0;
+        for (let i = 1; i < passcode.length; i++) {
+            const current = Number.parseInt(passcode[i]);
+            const previous = Number.parseInt(passcode[i - 1]);
+            if (current === previous + 1) {
+                ascending++;
+            }
+            else if (current === previous - 1) {
+                descending++;
+            }
+        }
+        // If more than half the digits follow a pattern, consider it weak
+        return ascending >= 4 || descending >= 4;
+    }
+    /**
+     * Generate a secure random passcode
+     */
+    static generateSecurePasscode() {
+        let passcode;
+        let attempts = 0;
+        const maxAttempts = 100;
+        do {
+            // Generate 8 random digits, ensuring first digit is not 0
+            passcode = (Math.floor(Math.random() * 9) + 1).toString(); // First digit 1-9
+            for (let i = 1; i < 8; i++) {
+                passcode += Math.floor(Math.random() * 10).toString(); // Remaining digits 0-9
+            }
+            attempts++;
+            if (attempts > maxAttempts) {
+                throw new Error('Failed to generate secure passcode after maximum attempts');
+            }
+        } while (this.isWeakPasscode(passcode) || this.hasRepeatingPattern(passcode));
+        return Number.parseInt(passcode);
+    }
+    /**
+     * Generate a random discriminator
+     */
+    static generateRandomDiscriminator() {
+        return Math.floor(Math.random() * 4096);
+    }
+}
+//# sourceMappingURL=matterConfigValidator.js.map

package/dist/matterConfigValidator.js.map

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

package/dist/matterService.d.ts

@@ -0,0 +1,168 @@
+import { HomebridgeAPI } from './api.js';
+import { ExternalPortService } from './externalPortService.js';
+import { PlatformAccessory } from './platformAccessory.js';
+import { PluginManager } from './pluginManager.js';
+import { HomebridgeOptions } from './server.js';
+import '@matter/main';
+export interface MatterConfiguration {
+    enabled?: boolean;
+    port?: number;
+    discriminator?: number;
+    passcode?: number;
+    vendorId?: number;
+    productId?: number;
+    deviceName?: string;
+    deviceType?: number;
+    storageDir?: string;
+    debugEnabled?: boolean;
+    interfaceName?: string;
+    announceInterval?: number;
+    commissioningTimeout?: number;
+}
+export interface MatterBridgeOptions extends HomebridgeOptions {
+    matterConfig?: MatterConfiguration;
+}
+/**
+ * Matter service for publishing accessories via Matter protocol
+ * This runs alongside the existing HAP bridge service
+ */
+export declare class MatterService {
+    private matterConfiguration;
+    private pluginManager;
+    private externalPortService;
+    private api;
+    private options;
+    private matterServer;
+    private commissioningServer;
+    private storageManager;
+    private readonly isEnabled;
+    private readonly matterConfig;
+    private publishedAccessories;
+    private isInitialized;
+    private isStarted;
+    constructor(matterConfiguration: MatterConfiguration, pluginManager: PluginManager, externalPortService: ExternalPortService, api: HomebridgeAPI, options: HomebridgeOptions);
+    /**
+     * Validate Matter configuration parameters
+     */
+    private validateConfiguration;
+    /**
+     * Initialize the Matter server if enabled
+     */
+    initialize(): Promise<void>;
+    /**
+     * Initialize storage for Matter server
+     */
+    private initializeStorage;
+    /**
+     * Create the Matter server node
+     */
+    private createMatterServer;
+    /**
+     * Setup commissioning server for device pairing
+     */
+    private setupCommissioningServer;
+    /**
+     * Generate a unique serial number for the Matter bridge
+     */
+    private generateSerialNumber;
+    /**
+     * Generate a unique identifier for the Matter bridge
+     */
+    private generateUniqueId;
+    /**
+     * Log commissioning information for users
+     */
+    private logCommissioningInfo;
+    /**
+     * Format passcode for manual pairing
+     */
+    private formatPairingCode;
+    /**
+     * Start the Matter server
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the Matter server
+     */
+    stop(): Promise<void>;
+    /**
+     * Clean up resources
+     */
+    private cleanup;
+    /**
+     * Publish a platform accessory via Matter protocol
+     */
+    publishAccessory(accessory: PlatformAccessory): Promise<void>;
+    /**
+     * Unpublish a platform accessory from Matter protocol
+     */
+    unpublishAccessory(accessory: PlatformAccessory): Promise<void>;
+    /**
+     * Convert HAP accessory to Matter device
+     * This maps HAP services and characteristics to appropriate Matter clusters and attributes
+     */
+    private convertToMatterDevice;
+    /**
+     * Get the primary service from an accessory (excluding utility services)
+     */
+    private getPrimaryService;
+    /**
+     * Determine the appropriate Matter device type for a HAP service
+     */
+    private getMatterDeviceType;
+    /**
+     * Create a Matter device with the specified type and map characteristics
+     */
+    private createMatterDevice;
+    /**
+     * Get placeholder clusters for a device type
+     */
+    private getPlaceholderClusters;
+    /**
+     * Map HAP characteristics to Matter cluster attributes
+     */
+    private mapCharacteristicsToMatter;
+    /**
+     * Get the Matter cluster name for a HAP characteristic
+     */
+    private getMatterClusterForCharacteristic;
+    /**
+     * Get the Matter attribute name for a HAP characteristic
+     */
+    private getMatterAttributeForCharacteristic;
+    /**
+     * Get Matter server status
+     */
+    getStatus(): {
+        enabled: boolean;
+        running: boolean;
+        accessoryCount: number;
+        qrCode?: string;
+        setupCode?: string;
+    };
+    /**
+     * Get commissioning QR code for setup
+     */
+    getCommissioningQRCode(): string | null;
+    /**
+     * Get manual pairing code for setup
+     */
+    getManualPairingCode(): string | null;
+    /**
+     * Get list of published accessories
+     */
+    getPublishedAccessories(): PlatformAccessory[];
+    /**
+     * Check if an accessory is published via Matter
+     */
+    isAccessoryPublished(accessory: PlatformAccessory): boolean;
+    /**
+     * Get Matter configuration (read-only)
+     */
+    getConfiguration(): Readonly<MatterConfiguration>;
+    /**
+     * Force restart the Matter server (for configuration changes)
+     */
+    restart(): Promise<void>;
+}
+//# sourceMappingURL=matterService.d.ts.map

package/dist/matterService.d.ts.map

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