homebridge 2.0.0-beta.6 → 2.0.0-beta.61

package/dist/matter/clusterTypes.d.ts

@@ -0,0 +1,182 @@
+import type { WindowCovering } from '@matter/main/clusters';
+export interface ClusterState {
+    [key: string]: unknown;
+}
+export interface OnOffState {
+    onOff?: boolean;
+}
+export interface LevelControlState {
+    currentLevel?: number;
+    minLevel?: number;
+    maxLevel?: number;
+    remainingTime?: number;
+    onLevel?: number | null;
+    options?: number;
+}
+export interface ColorControlState {
+    colorTemperatureMireds?: number;
+    colorTempPhysicalMinMireds?: number;
+    colorTempPhysicalMaxMireds?: number;
+    currentHue?: number;
+    currentSaturation?: number;
+    enhancedCurrentHue?: number;
+    currentX?: number;
+    currentY?: number;
+    colorX?: number;
+    colorY?: number;
+    colorMode?: number;
+    enhancedColorMode?: number;
+    options?: number;
+    transitionTime?: number;
+}
+export interface ColorTemperatureState {
+    colorTemperatureMireds?: number;
+}
+export interface HueSaturationState {
+    currentHue?: number;
+    currentSaturation?: number;
+}
+export interface XYColorState {
+    currentX?: number;
+    currentY?: number;
+}
+export interface HueState {
+    currentHue?: number;
+    enhancedCurrentHue?: number;
+}
+export interface SaturationState {
+    currentSaturation?: number;
+}
+export interface WindowCoveringState {
+    type?: WindowCovering.WindowCoveringType;
+    configStatus?: {
+        operational?: boolean;
+        online?: boolean;
+        liftMovementReversed?: boolean;
+        liftPositionAware?: boolean;
+        tiltPositionAware?: boolean;
+        liftEncoderControlled?: boolean;
+        tiltEncoderControlled?: boolean;
+    };
+    targetPositionLiftPercent100ths?: number | null;
+    currentPositionLiftPercent100ths?: number | null;
+    targetPositionTiltPercent100ths?: number | null;
+    currentPositionTiltPercent100ths?: number | null;
+    operationalStatus?: number;
+    safetyStatus?: number;
+    mode?: number;
+}
+export interface FanControlState {
+    fanMode?: number;
+    fanModeSequence?: number;
+    percentSetting?: number | null;
+    percentCurrent?: number;
+    speedMax?: number;
+    speedSetting?: number | null;
+    speedCurrent?: number;
+    rockSupport?: number;
+    rockSetting?: number;
+    windSupport?: number;
+    windSetting?: number;
+}
+export interface ThermostatState {
+    localTemperature?: number | null;
+    externalMeasuredIndoorTemperature?: number | null;
+    outdoorTemperature?: number | null;
+    occupancy?: {
+        occupied?: boolean;
+    };
+    externallyMeasuredOccupancy?: boolean;
+    absMinHeatSetpointLimit?: number;
+    absMaxHeatSetpointLimit?: number;
+    absMinCoolSetpointLimit?: number;
+    absMaxCoolSetpointLimit?: number;
+    occupiedCoolingSetpoint?: number;
+    occupiedHeatingSetpoint?: number;
+    unoccupiedCoolingSetpoint?: number;
+    unoccupiedHeatingSetpoint?: number;
+    minHeatSetpointLimit?: number;
+    maxHeatSetpointLimit?: number;
+    minCoolSetpointLimit?: number;
+    maxCoolSetpointLimit?: number;
+    minSetpointDeadBand?: number;
+    remoteSensing?: number;
+    controlSequenceOfOperation?: number;
+    systemMode?: number;
+    thermostatRunningMode?: number;
+    startOfWeek?: number;
+    numberOfWeeklyTransitions?: number;
+    numberOfDailyTransitions?: number;
+}
+export interface DoorLockState {
+    lockState?: number | null;
+    lockType?: number;
+    actuatorEnabled?: boolean;
+    doorState?: number | null;
+    doorOpenEvents?: number;
+    doorClosedEvents?: number;
+    openPeriod?: number;
+}
+export interface RvcOperationalState {
+    phaseList?: string[] | null;
+    currentPhase?: number | null;
+    countdownTime?: number | null;
+    operationalStateList?: Array<{
+        operationalStateId: number;
+        operationalStateLabel?: string;
+    }>;
+    operationalState?: number;
+    operationalError?: {
+        errorStateId: number;
+        errorStateLabel?: string;
+        errorStateDetails?: string;
+    };
+}
+export interface RvcRunModeState {
+    supportedModes?: Array<{
+        label: string;
+        mode: number;
+        modeTags?: Array<{
+            value: number;
+        }>;
+    }>;
+    currentMode?: number;
+    startUpMode?: number | null;
+    onMode?: number | null;
+}
+export interface RvcCleanModeState {
+    supportedModes?: Array<{
+        label: string;
+        mode: number;
+        modeTags?: Array<{
+            value: number;
+        }>;
+    }>;
+    currentMode?: number;
+    startUpMode?: number | null;
+    onMode?: number | null;
+}
+export interface ServiceAreaState {
+    supportedAreas?: Array<{
+        areaId: number;
+        mapId: number | null;
+        areaInfo: {
+            locationName?: string;
+            floorNumber?: number | null;
+            areaType?: number | null;
+        };
+    }>;
+    supportedMaps?: Array<{
+        mapId: number;
+        name: string;
+    }>;
+    selectedAreas?: number[];
+    currentArea?: number | null;
+    estimatedEndTime?: number | null;
+    progress?: Array<{
+        areaId: number;
+        status: number;
+        totalOperationalTime?: number | null;
+    }>;
+}
+//# sourceMappingURL=clusterTypes.d.ts.map

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

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

package/dist/matter/clusterTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=clusterTypes.js.map

package/dist/matter/clusterTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clusterTypes.js","sourceRoot":"","sources":["../../src/matter/clusterTypes.ts"],"names":[],"mappings":""}

package/dist/matter/config.d.ts

@@ -0,0 +1,9 @@
+import type { HomebridgeConfig } from '../bridgeService.js';
+export declare class MatterConfigCollector {
+    static hasMatterConfig(config: HomebridgeConfig): boolean;
+    static collectConfiguredMatterPorts(config: HomebridgeConfig): number[];
+    static validateMatterPortsPool(config: HomebridgeConfig): void;
+    static validateMatterConfig(config: HomebridgeConfig): Promise<void>;
+    private static checkPortConflicts;
+}
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/matter/config.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAmB,gBAAgB,EAAkB,MAAM,qBAAqB,CAAA;AAS5F,qBAAa,qBAAqB;IAIhC,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO;IAWzD,MAAM,CAAC,4BAA4B,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,EAAE;IA4BvE,MAAM,CAAC,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;WAmBjD,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuC1E,OAAO,CAAC,MAAM,CAAC,kBAAkB;CA+BlC"}

package/dist/matter/config.js

@@ -0,0 +1,84 @@
+import { Logger } from '../logger.js';
+const log = Logger.withPrefix('Matter/Config');
+export class MatterConfigCollector {
+    static hasMatterConfig(config) {
+        return !!(config.bridge.matter
+            || config.platforms.some((p) => p._bridge?.matter)
+            || config.accessories.some((a) => a._bridge?.matter));
+    }
+    static collectConfiguredMatterPorts(config) {
+        const configuredMatterPorts = [];
+        if (config.bridge.matter?.port) {
+            configuredMatterPorts.push(config.bridge.matter.port);
+        }
+        for (const platform of config.platforms) {
+            if (platform._bridge?.matter?.port) {
+                configuredMatterPorts.push(platform._bridge.matter.port);
+            }
+        }
+        for (const accessory of config.accessories) {
+            if (accessory._bridge?.matter?.port) {
+                configuredMatterPorts.push(accessory._bridge.matter.port);
+            }
+        }
+        return configuredMatterPorts;
+    }
+    static validateMatterPortsPool(config) {
+        if (config.matterPorts !== undefined) {
+            if (config.matterPorts.start && config.matterPorts.end) {
+                if (config.matterPorts.start > config.matterPorts.end) {
+                    log.error('Invalid Matter port pool configuration. End should be greater than or equal to start.');
+                    config.matterPorts = undefined;
+                }
+            }
+            else {
+                log.error('Invalid configuration for \'matterPorts\'. Missing \'start\' and \'end\' properties! Ignoring it!');
+                config.matterPorts = undefined;
+            }
+        }
+    }
+    static async validateMatterConfig(config) {
+        if (!this.hasMatterConfig(config)) {
+            return;
+        }
+        const { MatterConfigValidator } = await import('./configValidator.js');
+        if (config.bridge.matter) {
+            const validation = MatterConfigValidator.validate(config.bridge.matter);
+            if (!validation.isValid) {
+                log.error('Main bridge Matter configuration is invalid. Matter will not be enabled for the main bridge.');
+                delete config.bridge.matter;
+            }
+        }
+        const childMatterValidation = MatterConfigValidator.validateAllChildMatterConfigs(config.platforms, config.accessories);
+        if (!childMatterValidation.isValid) {
+            log.error('Some child bridge Matter configurations are invalid. Check the errors above.');
+        }
+        if (config.bridge.matter?.port) {
+            this.checkPortConflicts(config);
+        }
+    }
+    static checkPortConflicts(config) {
+        const mainMatterPort = config.bridge.matter?.port;
+        if (!mainMatterPort) {
+            return;
+        }
+        const childMatterPorts = [];
+        for (const platform of config.platforms) {
+            if (platform._bridge?.matter?.port) {
+                childMatterPorts.push(platform._bridge.matter.port);
+            }
+        }
+        for (const accessory of config.accessories) {
+            if (accessory._bridge?.matter?.port) {
+                childMatterPorts.push(accessory._bridge.matter.port);
+            }
+        }
+        if (childMatterPorts.includes(mainMatterPort)) {
+            log.error(`Main bridge Matter port ${mainMatterPort} conflicts with a child bridge Matter port. Please use unique ports.`);
+        }
+        if (config.bridge.port && Math.abs(config.bridge.port - mainMatterPort) < 10) {
+            log.warn(`Main bridge HAP port ${config.bridge.port} and Matter port ${mainMatterPort} are very close. Consider spacing them further apart.`);
+        }
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/matter/config.js.map

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

package/dist/matter/configValidator.d.ts

@@ -0,0 +1,26 @@
+import type { AccessoryConfig, PlatformConfig } from '../bridgeService.js';
+export interface PortValidationResult {
+    valid: boolean;
+    error?: string;
+    warning?: string;
+}
+export interface SanitizationResult<T> {
+    value: T;
+    warnings: string[];
+}
+export interface MatterConfigValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export declare function validatePort(port: number, checkConflicts?: boolean): PortValidationResult;
+export declare function sanitizeUniqueId(uniqueId: string): SanitizationResult<string>;
+export declare function truncateString(value: string, maxLength: number, fieldName: string): SanitizationResult<string>;
+export declare function checkPortProximity(hapPort: number, matterPort: number): string | undefined;
+export declare class MatterConfigValidator {
+    static validate(config: Record<string, unknown>): MatterConfigValidationResult;
+    private static validatePort;
+    static validateChildMatterConfig(config: PlatformConfig | AccessoryConfig, configType: 'platform' | 'accessory', identifier: string): MatterConfigValidationResult;
+    static validateAllChildMatterConfigs(platforms: PlatformConfig[], accessories: AccessoryConfig[]): MatterConfigValidationResult;
+}
+//# sourceMappingURL=configValidator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configValidator.d.ts","sourceRoot":"","sources":["../../src/matter/configValidator.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAS1E,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAKD,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,KAAK,EAAE,CAAC,CAAA;IACR,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAaD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,UAAQ,GAAG,oBAAoB,CAqBvF;AAWD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAuB7E;AAUD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,kBAAkB,CAAC,MAAM,CAAC,CAa5B;AASD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQ1F;AASD,qBAAa,qBAAqB;IAIhC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,4BAA4B;IAyB9E,OAAO,CAAC,MAAM,CAAC,YAAY;IAoB3B,MAAM,CAAC,yBAAyB,CAC9B,MAAM,EAAE,cAAc,GAAG,eAAe,EACxC,UAAU,EAAE,UAAU,GAAG,WAAW,EACpC,UAAU,EAAE,MAAM,GACjB,4BAA4B;IAsD/B,MAAM,CAAC,6BAA6B,CAClC,SAAS,EAAE,cAAc,EAAE,EAC3B,WAAW,EAAE,eAAe,EAAE,GAC7B,4BAA4B;CA2DhC"}

package/dist/matter/configValidator.js

@@ -0,0 +1,173 @@
+import { Logger } from '../logger.js';
+const log = Logger.withPrefix('Matter/Config');
+export function validatePort(port, checkConflicts = false) {
+    if (!Number.isInteger(port)) {
+        return { valid: false, error: `Port must be an integer (got: ${port})` };
+    }
+    if (port < 1025 || port > 65534) {
+        return { valid: false, error: `Port must be between 1025 and 65534 (got: ${port})` };
+    }
+    if (checkConflicts) {
+        const conflictPorts = [5353, 8080, 8443];
+        if (conflictPorts.includes(port)) {
+            return {
+                valid: true,
+                warning: `Port ${port} may conflict with other services. Consider using a different port.`,
+            };
+        }
+    }
+    return { valid: true };
+}
+export function sanitizeUniqueId(uniqueId) {
+    const warnings = [];
+    const original = uniqueId;
+    if (uniqueId.trim().length === 0) {
+        return {
+            value: '',
+            warnings: ['uniqueId is empty after trimming'],
+        };
+    }
+    const sanitized = uniqueId.replace(/:/g, '').toUpperCase();
+    if (sanitized !== original) {
+        warnings.push(`uniqueId was sanitized from "${original}" to "${sanitized}"`);
+    }
+    if (sanitized.length === 0) {
+        warnings.push('uniqueId resulted in empty string after sanitization');
+    }
+    return { value: sanitized, warnings };
+}
+export function truncateString(value, maxLength, fieldName) {
+    const warnings = [];
+    if (value.length > maxLength) {
+        warnings.push(`${fieldName} exceeds ${maxLength} characters, truncating: ${value}`);
+        log.warn(`${fieldName} exceeds ${maxLength} characters, truncating: ${value}`);
+        return {
+            value: value.slice(0, maxLength),
+            warnings,
+        };
+    }
+    return { value, warnings };
+}
+export function checkPortProximity(hapPort, matterPort) {
+    const MIN_PORT_SEPARATION = 10;
+    if (Math.abs(hapPort - matterPort) < MIN_PORT_SEPARATION) {
+        return `HAP port ${hapPort} and Matter port ${matterPort} are very close. Consider spacing them further apart.`;
+    }
+    return undefined;
+}
+export class MatterConfigValidator {
+    static validate(config) {
+        const result = {
+            isValid: true,
+            errors: [],
+            warnings: [],
+        };
+        this.validatePort(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 validatePort(config, result) {
+        const port = config.port;
+        if (port !== undefined && port !== null) {
+            if (typeof port === 'number') {
+                const validation = validatePort(port, true);
+                if (!validation.valid) {
+                    result.errors.push(validation.error);
+                }
+                else if (validation.warning) {
+                    result.warnings.push(validation.warning);
+                }
+            }
+            else {
+                result.errors.push(`Port must be a number, got ${typeof port}.`);
+            }
+        }
+    }
+    static validateChildMatterConfig(config, configType, identifier) {
+        const result = {
+            isValid: true,
+            errors: [],
+            warnings: [],
+        };
+        if (!config._bridge?.matter) {
+            return result;
+        }
+        const matterConfig = config._bridge.matter;
+        const prefix = `Child Matter bridge for ${configType} "${identifier}"`;
+        if (matterConfig.port !== undefined) {
+            const validation = validatePort(matterConfig.port, false);
+            if (!validation.valid) {
+                result.errors.push(`${prefix}: ${validation.error}`);
+                result.isValid = false;
+            }
+        }
+        else {
+            result.warnings.push(`${prefix}: No port specified. Port will be auto-allocated.`);
+        }
+        if (config._bridge && config._bridge.matter) {
+            if (config._bridge.port && matterConfig.port) {
+                const proximityWarning = checkPortProximity(config._bridge.port, matterConfig.port);
+                if (proximityWarning) {
+                    result.warnings.push(`${prefix}: ${proximityWarning}`);
+                }
+            }
+        }
+        if (result.errors.length > 0) {
+            log.error(`${prefix} validation errors:`);
+            result.errors.forEach(error => log.error(`  - ${error}`));
+        }
+        if (result.warnings.length > 0) {
+            log.warn(`${prefix} validation warnings:`);
+            result.warnings.forEach(warning => log.warn(`  - ${warning}`));
+        }
+        return result;
+    }
+    static validateAllChildMatterConfigs(platforms, accessories) {
+        const result = {
+            isValid: true,
+            errors: [],
+            warnings: [],
+        };
+        const usedPorts = new Set();
+        for (const platform of platforms) {
+            if (platform._bridge?.matter) {
+                const validation = this.validateChildMatterConfig(platform, 'platform', platform.platform || 'unknown');
+                result.errors.push(...validation.errors);
+                result.warnings.push(...validation.warnings);
+                result.isValid = result.isValid && validation.isValid;
+                if (platform._bridge.matter.port) {
+                    if (usedPorts.has(platform._bridge.matter.port)) {
+                        result.errors.push(`Duplicate Matter port ${platform._bridge.matter.port} detected. Each Matter bridge must use a unique port.`);
+                        result.isValid = false;
+                    }
+                    usedPorts.add(platform._bridge.matter.port);
+                }
+            }
+        }
+        for (const accessory of accessories) {
+            if (accessory._bridge?.matter) {
+                const validation = this.validateChildMatterConfig(accessory, 'accessory', accessory.accessory || 'unknown');
+                result.errors.push(...validation.errors);
+                result.warnings.push(...validation.warnings);
+                result.isValid = result.isValid && validation.isValid;
+                if (accessory._bridge.matter.port) {
+                    if (usedPorts.has(accessory._bridge.matter.port)) {
+                        result.errors.push(`Duplicate Matter port ${accessory._bridge.matter.port} detected. Each Matter bridge must use a unique port.`);
+                        result.isValid = false;
+                    }
+                    usedPorts.add(accessory._bridge.matter.port);
+                }
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=configValidator.js.map

package/dist/matter/configValidator.js.map

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

package/dist/matter/errorHandler.d.ts

@@ -0,0 +1,11 @@
+import { MatterError } from './types.js';
+export declare class MatterErrorHandler {
+    private static instance;
+    private constructor();
+    static getInstance(): MatterErrorHandler;
+    handleError(error: Error | MatterError, context?: string): Promise<void>;
+    private categorizeError;
+    private logError;
+}
+export declare const errorHandler: MatterErrorHandler;
+//# sourceMappingURL=errorHandler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.d.ts","sourceRoot":"","sources":["../../src/matter/errorHandler.ts"],"names":[],"mappings":"AAWA,OAAO,EAGL,WAAW,EAIZ,MAAM,YAAY,CAAA;AAQnB,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAoB;IAE3C,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,kBAAkB;IAUlC,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9E,OAAO,CAAC,eAAe;IA4EvB,OAAO,CAAC,QAAQ;CA6BjB;AAGD,eAAO,MAAM,YAAY,oBAAmC,CAAA"}

package/dist/matter/errorHandler.js

@@ -0,0 +1,81 @@
+import { Logger } from '../logger.js';
+import { MatterCommissioningError, MatterDeviceError, MatterError, MatterErrorType, MatterNetworkError, MatterStorageError, } from './types.js';
+const log = Logger.withPrefix('Matter/Errors');
+export class MatterErrorHandler {
+    static instance;
+    constructor() { }
+    static getInstance() {
+        if (!MatterErrorHandler.instance) {
+            MatterErrorHandler.instance = new MatterErrorHandler();
+        }
+        return MatterErrorHandler.instance;
+    }
+    async handleError(error, context) {
+        const matterError = this.categorizeError(error, context);
+        this.logError(matterError);
+    }
+    categorizeError(error, context) {
+        if (error instanceof MatterError) {
+            return error;
+        }
+        const errorMessage = error.message.toLowerCase();
+        if (errorMessage.includes('eaddrinuse')) {
+            return new MatterNetworkError(`Port is already in use: ${error.message}`, { code: 'PORT_IN_USE', recoverable: false });
+        }
+        if (errorMessage.includes('econnrefused') || errorMessage.includes('etimedout')) {
+            return new MatterNetworkError(`Connection failed: ${error.message}`, { code: 'CONNECTION_FAILED', recoverable: true });
+        }
+        if (errorMessage.includes('commissioning') || errorMessage.includes('pairing')) {
+            return new MatterCommissioningError(`Commissioning error: ${error.message}`, { recoverable: false });
+        }
+        if (errorMessage.includes('storage') || errorMessage.includes('enoent') || errorMessage.includes('corrupted')) {
+            return new MatterStorageError(`Storage error: ${error.message}`, { recoverable: true });
+        }
+        if (errorMessage.includes('config') || errorMessage.includes('invalid')) {
+            return new MatterError(`Configuration error: ${error.message}`, 'CONFIGURATION_ERROR', { recoverable: false, type: MatterErrorType.CONFIGURATION });
+        }
+        if (context?.includes('sync') || context?.includes('device')) {
+            return new MatterDeviceError(`Device sync error: ${error.message}`, { recoverable: true, context });
+        }
+        if (context?.includes('server')) {
+            return new MatterError(`Server error: ${error.message}`, 'SERVER_ERROR', { recoverable: true, type: MatterErrorType.SERVER, context });
+        }
+        return new MatterError(error.message || 'Unknown Matter error', 'UNKNOWN_ERROR', { recoverable: false, type: MatterErrorType.UNKNOWN, originalError: error });
+    }
+    logError(error) {
+        if (error instanceof MatterNetworkError) {
+            if (error.details?.code === 'PORT_IN_USE') {
+                log.error('Matter port is already in use. Please configure a different port in your config.json.');
+            }
+            else {
+                log.warn(`Matter network error: ${error.message}`);
+            }
+        }
+        else if (error instanceof MatterCommissioningError) {
+            log.info(`Matter commissioning issue: ${error.message}`);
+        }
+        else if (error instanceof MatterDeviceError) {
+            log.debug(`Device sync error: ${error.message}`);
+        }
+        else if (error instanceof MatterStorageError) {
+            log.warn(`Matter storage error: ${error.message}`);
+            if (error.message.includes('corrupted')) {
+                log.warn('If this persists, you may need to delete the Matter storage directory and re-pair your devices.');
+            }
+        }
+        else if (error.code === 'CONFIGURATION_ERROR') {
+            log.error(`Matter configuration error: ${error.message}`);
+        }
+        else if (error.code === 'SERVER_ERROR') {
+            log.error(`Matter server error: ${error.message}`);
+        }
+        else {
+            log.error(`Matter error: ${error.message}`);
+        }
+        if (!error.recoverable && error.stack) {
+            log.debug('Stack trace:', error.stack);
+        }
+    }
+}
+export const errorHandler = MatterErrorHandler.getInstance();
+//# sourceMappingURL=errorHandler.js.map

package/dist/matter/errorHandler.js.map

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