homebridge 2.0.0-alpha.5 → 2.0.0-alpha.51

package/dist/matter/index.js

@@ -0,0 +1,11 @@
+/**
+ * Matter Protocol Support for Homebridge
+ *
+ * This module provides Matter protocol support through a Plugin API,
+ * allowing plugin developers to explicitly register Matter accessories.
+ */
+export { MatterConfigValidator } from './matterConfigValidator.js';
+export { MatterServer } from './matterServer.js';
+export { HomebridgeMatterStorage, MatterStorageManager } from './matterStorage.js';
+export { clusterNames, clusters, devices, deviceTypes, MatterCommissioningError, MatterDeviceError, MatterError, MatterErrorType, MatterNetworkError, MatterStorageError, } from './matterTypes.js';
+//# sourceMappingURL=index.js.map

package/dist/matter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/matter/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,OAAO,EAAqC,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AACrG,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAClF,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,WAAW,EAMX,wBAAwB,EAExB,iBAAiB,EACjB,WAAW,EAEX,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,kBAAkB,CAAA"}

package/dist/matter/matterAccessoryCache.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Matter Accessory Cache
+ *
+ * Handles persistence of Matter accessories across Homebridge restarts.
+ * Similar to HAP's cached accessories, but designed for Matter's simpler API.
+ */
+import type { InternalMatterAccessory } from './matterTypes.js';
+/**
+ * Serializable Matter accessory (excludes functions and runtime state)
+ */
+export interface SerializedMatterAccessory {
+    plugin: string;
+    platform: string;
+    uuid: string;
+    displayName: string;
+    deviceType: {
+        name?: string;
+        code?: number;
+    };
+    serialNumber: string;
+    manufacturer: string;
+    model: string;
+    firmwareRevision?: string;
+    hardwareRevision?: string;
+    softwareVersion?: string;
+    context?: Record<string, any>;
+    clusters: {
+        [clusterName: string]: {
+            [attributeName: string]: any;
+        };
+    };
+}
+/**
+ * Matter Accessory Cache Manager
+ */
+export declare class MatterAccessoryCache {
+    private readonly cacheFilePath;
+    private cachedAccessories;
+    private cacheLoaded;
+    private saveQueue;
+    private directoryEnsured;
+    constructor(storagePath: string, bridgeId: string);
+    /**
+     * Load cached accessories from disk
+     */
+    load(): Promise<Map<string, SerializedMatterAccessory>>;
+    /**
+     * Save accessories to cache (serialized to prevent concurrent write conflicts)
+     * Uses a queue pattern to ensure saves are truly serialized even when called concurrently
+     */
+    save(accessories: Map<string, InternalMatterAccessory>): Promise<void>;
+    /**
+     * Internal save implementation
+     */
+    private performSave;
+    /**
+     * Get cached accessory by UUID
+     */
+    getCached(uuid: string): SerializedMatterAccessory | undefined;
+    /**
+     * Check if an accessory is cached
+     */
+    hasCached(uuid: string): boolean;
+    /**
+     * Remove an accessory from cache
+     */
+    removeCached(uuid: string): void;
+    /**
+     * Get all cached accessories
+     */
+    getAllCached(): Map<string, SerializedMatterAccessory>;
+    /**
+     * Serialize a Matter accessory for storage
+     */
+    private serializeAccessory;
+}
+//# sourceMappingURL=matterAccessoryCache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"matterAccessoryCache.d.ts","sourceRoot":"","sources":["../../src/matter/matterAccessoryCache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAU/D;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE;QACV,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;IACD,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC7B,QAAQ,EAAE;QACR,CAAC,WAAW,EAAE,MAAM,GAAG;YACrB,CAAC,aAAa,EAAE,MAAM,GAAG,GAAG,CAAA;SAC7B,CAAA;KACF,CAAA;CACF;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;IACtC,OAAO,CAAC,iBAAiB,CAAoD;IAC7E,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,gBAAgB,CAAQ;gBAEpB,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAIjD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;IAmD7D;;;OAGG;IACG,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5E;;OAEG;YACW,WAAW;IAgDzB;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,yBAAyB,GAAG,SAAS;IAI9D;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIhC;;OAEG;IACH,YAAY,IAAI,GAAG,CAAC,MAAM,EAAE,yBAAyB,CAAC;IAItD;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAwB3B"}

package/dist/matter/matterAccessoryCache.js

@@ -0,0 +1,176 @@
+/**
+ * Matter Accessory Cache
+ *
+ * Handles persistence of Matter accessories across Homebridge restarts.
+ * Similar to HAP's cached accessories, but designed for Matter's simpler API.
+ */
+import * as path from 'node:path';
+import fs from 'fs-extra';
+import { Logger } from '../logger.js';
+const log = Logger.withPrefix('Matter/Accessories');
+/**
+ * Matter Accessory Cache Manager
+ */
+export class MatterAccessoryCache {
+    cacheFilePath;
+    cachedAccessories = new Map();
+    cacheLoaded = false;
+    saveQueue = Promise.resolve();
+    directoryEnsured = false;
+    constructor(storagePath, bridgeId) {
+        this.cacheFilePath = path.join(storagePath, bridgeId, 'accessories.json');
+    }
+    /**
+     * Load cached accessories from disk
+     */
+    async load() {
+        if (this.cacheLoaded) {
+            return this.cachedAccessories;
+        }
+        try {
+            // Ensure cache file exists
+            if (!await fs.pathExists(this.cacheFilePath)) {
+                log.info('No cached Matter accessories found (first run)');
+                this.cacheLoaded = true;
+                return this.cachedAccessories;
+            }
+            // Read and parse cache file
+            const cacheData = await fs.readJson(this.cacheFilePath);
+            if (!Array.isArray(cacheData)) {
+                log.warn('Invalid Matter accessory cache format, deleting corrupted file');
+                await fs.remove(this.cacheFilePath);
+                this.cacheLoaded = true;
+                return this.cachedAccessories;
+            }
+            // Load accessories into map
+            for (const serialized of cacheData) {
+                if (serialized.uuid) {
+                    this.cachedAccessories.set(serialized.uuid, serialized);
+                }
+            }
+            log.info(`Loaded ${this.cachedAccessories.size} cached Matter accessories`);
+            this.cacheLoaded = true;
+            // Directory must exist if we successfully loaded the cache file
+            this.directoryEnsured = true;
+            return this.cachedAccessories;
+        }
+        catch (error) {
+            // If JSON parsing failed (corrupted file), delete it and start fresh
+            log.error(`Failed to load Matter accessory cache: ${this.cacheFilePath}: ${error.message}`);
+            log.warn('Deleting corrupted cache file and starting fresh');
+            try {
+                await fs.remove(this.cacheFilePath);
+            }
+            catch (removeError) {
+                log.debug('Could not delete corrupted cache file:', removeError);
+            }
+            this.cacheLoaded = true;
+            return this.cachedAccessories;
+        }
+    }
+    /**
+     * Save accessories to cache (serialized to prevent concurrent write conflicts)
+     * Uses a queue pattern to ensure saves are truly serialized even when called concurrently
+     */
+    async save(accessories) {
+        // Chain this save to the end of the queue
+        // This ensures all saves run sequentially without race conditions
+        this.saveQueue = this.saveQueue.then(() => this.performSave(accessories));
+        // Wait for this save to complete
+        await this.saveQueue;
+    }
+    /**
+     * Internal save implementation
+     */
+    async performSave(accessories) {
+        const tempFilePath = `${this.cacheFilePath}.tmp`;
+        try {
+            // Serialize accessories (strip out functions)
+            const serialized = [];
+            for (const accessory of accessories.values()) {
+                serialized.push(this.serializeAccessory(accessory));
+            }
+            // Ensure directory exists (only check once, not on every save)
+            if (!this.directoryEnsured) {
+                const directory = path.dirname(this.cacheFilePath);
+                await fs.ensureDir(directory);
+                // Verify directory was created successfully
+                const dirExists = await fs.pathExists(directory);
+                if (!dirExists) {
+                    throw new Error(`Failed to create cache directory: ${directory}`);
+                }
+                this.directoryEnsured = true;
+                log.debug(`Cache directory ensured: ${directory}`);
+            }
+            // Write to temporary file first (atomic write pattern to prevent corruption)
+            await fs.writeJson(tempFilePath, serialized, { spaces: 2 });
+            // Atomically move temp file to final location
+            // Use move instead of rename for better cross-device compatibility
+            await fs.move(tempFilePath, this.cacheFilePath, { overwrite: true });
+            log.debug(`Saved ${serialized.length} Matter accessories to cache`);
+        }
+        catch (error) {
+            log.error(`Failed to save Matter accessory cache: ${error.message}`);
+            // Clean up temp file if it exists
+            try {
+                if (await fs.pathExists(tempFilePath)) {
+                    await fs.remove(tempFilePath);
+                }
+            }
+            catch (cleanupError) {
+                log.debug('Could not clean up temporary cache file:', cleanupError);
+            }
+        }
+    }
+    /**
+     * Get cached accessory by UUID
+     */
+    getCached(uuid) {
+        return this.cachedAccessories.get(uuid);
+    }
+    /**
+     * Check if an accessory is cached
+     */
+    hasCached(uuid) {
+        return this.cachedAccessories.has(uuid);
+    }
+    /**
+     * Remove an accessory from cache
+     */
+    removeCached(uuid) {
+        this.cachedAccessories.delete(uuid);
+    }
+    /**
+     * Get all cached accessories
+     */
+    getAllCached() {
+        return new Map(this.cachedAccessories);
+    }
+    /**
+     * Serialize a Matter accessory for storage
+     */
+    serializeAccessory(accessory) {
+        // Extract device type information
+        const deviceType = accessory.deviceType;
+        const deviceTypeInfo = {
+            name: deviceType?.name,
+            code: deviceType?.code,
+        };
+        return {
+            plugin: accessory._associatedPlugin || '',
+            platform: accessory._associatedPlatform || '',
+            uuid: accessory.uuid,
+            displayName: accessory.displayName,
+            deviceType: deviceTypeInfo,
+            serialNumber: accessory.serialNumber,
+            manufacturer: accessory.manufacturer,
+            model: accessory.model,
+            firmwareRevision: accessory.firmwareRevision,
+            hardwareRevision: accessory.hardwareRevision,
+            softwareVersion: accessory.softwareVersion,
+            context: accessory.context,
+            clusters: structuredClone(accessory.clusters),
+        };
+    }
+}
+//# sourceMappingURL=matterAccessoryCache.js.map

package/dist/matter/matterAccessoryCache.js.map

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

package/dist/matter/matterBehaviors.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Custom Matter Behavior Classes for Homebridge
+ *
+ * These custom behaviors extend the base Matter.js behaviors and override
+ * command methods to allow plugins to inject custom handlers.
+ *
+ * Note: Only clusters with user-triggered commands need custom behaviors.
+ * Read-only clusters (like sensors) don't need custom behaviors since
+ * they only report state, they don't receive commands.
+ */
+import type { MatterCommandHandler } from './matterTypes.js';
+import { ColorControlServer, DoorLockServer, IdentifyServer, LevelControlServer, OnOffServer, ThermostatServer, WindowCoveringServer } from '@matter/main/behaviors';
+/**
+ * Set the accessories map reference for cache syncing
+ */
+export declare function setAccessoriesMap(map: Map<string, any>): void;
+/**
+ * Register a handler for a specific endpoint/cluster/command
+ *
+ * @param endpointId - Unique endpoint identifier (typically the accessory UUID)
+ * @param clusterName - Name of the Matter cluster (e.g., 'onOff', 'levelControl')
+ * @param commandName - Name of the command method (e.g., 'on', 'off', 'moveToLevel')
+ * @param handler - Callback function to execute when the command is received
+ *
+ * @example
+ * ```typescript
+ * registerHandler('my-light-uuid', 'onOff', 'on', async () => {
+ *   console.log('Light turned on!')
+ * })
+ * ```
+ */
+export declare function registerHandler(endpointId: string, clusterName: string, commandName: string, handler: MatterCommandHandler): void;
+/**
+ * Custom OnOff Server that calls plugin handlers
+ */
+export declare class HomebridgeOnOffServer extends OnOffServer {
+    on(): any;
+    off(): any;
+    toggle(): any;
+}
+/**
+ * Custom LevelControl Server that calls plugin handlers
+ */
+export declare class HomebridgeLevelControlServer extends LevelControlServer {
+    moveToLevel(request: any): any;
+    moveToLevelWithOnOff(request: any): any;
+    move(request: any): any;
+    step(request: any): any;
+    stop(request: any): any;
+}
+/**
+ * Custom WindowCovering Server that calls plugin handlers
+ */
+export declare class HomebridgeWindowCoveringServer extends WindowCoveringServer {
+    upOrOpen(): any;
+    downOrClose(): any;
+    stopMotion(): any;
+}
+/**
+ * Custom DoorLock Server that calls plugin handlers
+ */
+export declare class HomebridgeDoorLockServer extends DoorLockServer {
+    lockDoor(): any;
+    unlockDoor(): any;
+}
+/**
+ * Custom Thermostat Server that calls plugin handlers
+ */
+export declare class HomebridgeThermostatServer extends ThermostatServer {
+    setpointRaiseLower(request: any): any;
+}
+/**
+ * Custom Identify Server that calls plugin handlers
+ */
+export declare class HomebridgeIdentifyServer extends IdentifyServer {
+    identify(request: any): any;
+}
+/**
+ * Custom ColorControl Server that calls plugin handlers
+ *
+ * ColorControl handles color changes for lights (hue, saturation, XY color, color temperature).
+ * Plugin developers can override these *Logic methods to handle color changes in their hardware.
+ *
+ * Features (Xy, ColorTemperature, HueSaturation) are added by the device type, not this behavior.
+ * This ensures each device only gets the features it needs.
+ */
+export declare class HomebridgeColorControlServer extends ColorControlServer {
+    /**
+     * Called when color temperature is changed
+     * @param targetMireds - Target color temperature in mireds (micro reciprocal degrees)
+     * @param transitionTime - Transition time in seconds (0 = as fast as possible)
+     */
+    moveToColorTemperatureLogic(targetMireds: number, transitionTime: number): any;
+    /**
+     * Called when hue and saturation are changed together
+     * @param targetHue - Target hue value (0-254 for normal hue, 0-65535 for enhanced hue)
+     * @param targetSaturation - Target saturation value (0-254)
+     * @param transitionTime - Transition time in seconds (0 = as fast as possible)
+     */
+    moveToHueAndSaturationLogic(targetHue: number, targetSaturation: number, transitionTime: number): any;
+    /**
+     * Called when XY color coordinates are changed
+     * @param targetX - Target X value (0-65535 representing 0.0-1.0 in CIE color space)
+     * @param targetY - Target Y value (0-65535 representing 0.0-1.0 in CIE color space)
+     * @param transitionTime - Transition time in seconds (0 = as fast as possible)
+     */
+    moveToColorLogic(targetX: number, targetY: number, transitionTime: number): any;
+    /**
+     * Called when hue is changed individually
+     * @param targetHue - Target hue value
+     * @param direction - Direction to move (shortest, longest, up, down)
+     * @param transitionTime - Transition time in seconds
+     * @param isEnhancedHue - Whether this is enhanced hue (16-bit) or normal hue (8-bit)
+     */
+    moveToHueLogic(targetHue: number, direction: any, transitionTime: number, isEnhancedHue?: boolean): any;
+    /**
+     * Called when saturation is changed individually
+     * @param targetSaturation - Target saturation value (0-254)
+     * @param transitionTime - Transition time in seconds
+     */
+    moveToSaturationLogic(targetSaturation: number, transitionTime: number): any;
+    /**
+     * Called when all color movement should be stopped
+     */
+    stopAllColorMovement(): any;
+}
+//# sourceMappingURL=matterBehaviors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"matterBehaviors.d.ts","sourceRoot":"","sources":["../../src/matter/matterBehaviors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAE5D,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,wBAAwB,CAAA;AAkB/B;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,QAEtD;AA4BD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,oBAAoB,QAc9B;AASD;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,WAAW;IAC3C,EAAE,IAAI,GAAG;IAyBT,GAAG,IAAI,GAAG;IAyBV,MAAM,IAAI,GAAG;CAuBvB;AAED;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,kBAAkB;IACzD,WAAW,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG;IAyB9B,oBAAoB,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG;IA+BvC,IAAI,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG;IAkBvB,IAAI,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG;IAkBvB,IAAI,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG;CAiBjC;AAED;;GAEG;AACH,qBAAa,8BAA+B,SAAQ,oBAAoB;IAC7D,QAAQ,IAAI,GAAG;IA+Bf,WAAW,IAAI,GAAG;IA+BlB,UAAU,IAAI,GAAG;CA8B3B;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,cAAc;IACjD,QAAQ,IAAI,GAAG;IA0Bf,UAAU,IAAI,GAAG;CAyB3B;AAED;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,gBAAgB;IACrD,kBAAkB,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG;CA8B/C;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,cAAc;IACjD,QAAQ,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG;CAiBrC;AAED;;;;;;;;GAQG;AACH,qBAAa,4BAA6B,SAAQ,kBAAkB;IAClE;;;;OAIG;IACM,2BAA2B,CAAC,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,GAAG;IA4BvF;;;;;OAKG;IACM,2BAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,GAAG;IA+B9G;;;;;OAKG;IACM,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,GAAG;IA+BxF;;;;;;OAMG;IACM,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,UAAQ,GAAG,GAAG;IA8B9G;;;;OAIG;IACM,qBAAqB,CAAC,gBAAgB,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,GAAG;IA4BrF;;OAEG;IACM,oBAAoB,IAAI,GAAG;CAiBrC"}