homebridge 2.0.0-alpha.43 → 2.0.0-alpha.44

package/dist/ipcService.js

@@ -11,11 +11,7 @@ export var IpcIncomingEvent;
     IpcIncomingEvent["STOP_MATTER_BRIDGE"] = "stopMatterBridge";
     IpcIncomingEvent["START_MATTER_BRIDGE"] = "startMatterBridge";
     IpcIncomingEvent["MATTER_BRIDGE_METADATA_REQUEST"] = "matterBridgeMetadataRequest";
-    IpcIncomingEvent["MATTER_ACCESSORIES_REQUEST"] = "matterAccessoriesRequest";
-    IpcIncomingEvent["TOGGLE_MATTER_DEVICE"] = "toggleMatterDevice";
     IpcIncomingEvent["MATTER_COMMISSIONING_INFO_REQUEST"] = "matterCommissioningInfoRequest";
-    IpcIncomingEvent["MATTER_DEVICE_READY"] = "matterDeviceReady";
-    IpcIncomingEvent["MATTER_DEVICE_REMOVED"] = "matterDeviceRemoved";
 })(IpcIncomingEvent || (IpcIncomingEvent = {}));
 // eslint-disable-next-line no-restricted-syntax
 export var IpcOutgoingEvent;
@@ -25,9 +21,6 @@ export var IpcOutgoingEvent;
     IpcOutgoingEvent["CHILD_BRIDGE_STATUS_UPDATE"] = "childBridgeStatusUpdate";
     IpcOutgoingEvent["MATTER_BRIDGE_METADATA_RESPONSE"] = "matterBridgeMetadataResponse";
     IpcOutgoingEvent["MATTER_BRIDGE_STATUS_UPDATE"] = "matterBridgeStatusUpdate";
-    IpcOutgoingEvent["MATTER_ACCESSORIES_RESPONSE"] = "matterAccessoriesResponse";
-    IpcOutgoingEvent["MATTER_DEVICE_STATUS_UPDATE"] = "matterDeviceStatusUpdate";
-    IpcOutgoingEvent["MATTER_COMMISSIONING_STATUS"] = "matterCommissioningStatus";
     IpcOutgoingEvent["MATTER_COMMISSIONING_INFO_RESPONSE"] = "matterCommissioningInfoResponse";
 })(IpcOutgoingEvent || (IpcOutgoingEvent = {}));
 // eslint-disable-next-line ts/no-unsafe-declaration-merging

package/dist/ipcService.js.map

@@ -1 +1 @@
-{"version":3,"file":"ipcService.js","sourceRoot":"","sources":["../src/ipcService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,OAAO,MAAM,cAAc,CAAA;AAElC,gDAAgD;AAChD,MAAM,CAAN,IAAkB,gBAcjB;AAdD,WAAkB,gBAAgB;IAChC,+DAA2C,CAAA;IAC3C,yDAAqC,CAAA;IACrC,2DAAuC,CAAA;IACvC,gFAA4D,CAAA;IAC5D,iEAA6C,CAAA;IAC7C,2DAAuC,CAAA;IACvC,6DAAyC,CAAA;IACzC,kFAA8D,CAAA;IAC9D,2EAAuD,CAAA;IACvD,+DAA2C,CAAA;IAC3C,wFAAoE,CAAA;IACpE,6DAAyC,CAAA;IACzC,iEAA6C,CAAA;AAC/C,CAAC,EAdiB,gBAAgB,KAAhB,gBAAgB,QAcjC;AAED,gDAAgD;AAChD,MAAM,CAAN,IAAkB,gBAUjB;AAVD,WAAkB,gBAAgB;IAChC,+DAA2C,CAAA;IAC3C,kFAA8D,CAAA;IAC9D,0EAAsD,CAAA;IACtD,oFAAgE,CAAA;IAChE,4EAAwD,CAAA;IACxD,6EAAyD,CAAA;IACzD,4EAAwD,CAAA;IACxD,6EAAyD,CAAA;IACzD,0FAAsE,CAAA;AACxE,CAAC,EAViB,gBAAgB,KAAhB,gBAAgB,QAUjC;AAOD,4DAA4D;AAC5D,MAAM,OAAO,UAAW,SAAQ,YAAY;IAC1C;QACE,KAAK,EAAE,CAAA;IACT,CAAC;IAED;;;OAGG;IACI,KAAK;QACV,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAoC,EAAE,EAAE;YAC7D,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;gBAC3D,OAAM;YACR,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;QACrC,CAAC,CAAC,CAAA;IACJ,CAAC;IAED;;;;OAIG;IACI,WAAW,CAAC,EAAoB,EAAE,IAAa;QACpD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC;gBACX,EAAE;gBACF,IAAI;aACL,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"ipcService.js","sourceRoot":"","sources":["../src/ipcService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,OAAO,MAAM,cAAc,CAAA;AAElC,gDAAgD;AAChD,MAAM,CAAN,IAAkB,gBAUjB;AAVD,WAAkB,gBAAgB;IAChC,+DAA2C,CAAA;IAC3C,yDAAqC,CAAA;IACrC,2DAAuC,CAAA;IACvC,gFAA4D,CAAA;IAC5D,iEAA6C,CAAA;IAC7C,2DAAuC,CAAA;IACvC,6DAAyC,CAAA;IACzC,kFAA8D,CAAA;IAC9D,wFAAoE,CAAA;AACtE,CAAC,EAViB,gBAAgB,KAAhB,gBAAgB,QAUjC;AAED,gDAAgD;AAChD,MAAM,CAAN,IAAkB,gBAOjB;AAPD,WAAkB,gBAAgB;IAChC,+DAA2C,CAAA;IAC3C,kFAA8D,CAAA;IAC9D,0EAAsD,CAAA;IACtD,oFAAgE,CAAA;IAChE,4EAAwD,CAAA;IACxD,0FAAsE,CAAA;AACxE,CAAC,EAPiB,gBAAgB,KAAhB,gBAAgB,QAOjC;AAOD,4DAA4D;AAC5D,MAAM,OAAO,UAAW,SAAQ,YAAY;IAC1C;QACE,KAAK,EAAE,CAAA;IACT,CAAC;IAED;;;OAGG;IACI,KAAK;QACV,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAoC,EAAE,EAAE;YAC7D,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;gBAC3D,OAAM;YACR,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;QACrC,CAAC,CAAC,CAAA;IACJ,CAAC;IAED;;;;OAIG;IACI,WAAW,CAAC,EAAoB,EAAE,IAAa;QACpD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC;gBACX,EAAE;gBACF,IAAI;aACL,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/matter/index.d.ts

@@ -7,5 +7,5 @@
 export { type MatterConfigValidationResult, MatterConfigValidator } from './matterConfigValidator.js';
 export { MatterServer } from './matterServer.js';
 export { HomebridgeMatterStorage, MatterStorageManager } from './matterStorage.js';
-export { clusters, devices, deviceTypes, type InternalMatterAccessory, type MatterAccessory, MatterCommissioningError, type MatterConfig, MatterDeviceError, MatterError, MatterErrorType, MatterNetworkError, MatterStorageError, } from './matterTypes.js';
+export { clusters, devices, deviceTypes, type InternalMatterAccessory, type MatterAccessory, type MatterClusterHandlers, type MatterCommandHandler, MatterCommissioningError, type MatterConfig, MatterDeviceError, MatterError, type MatterErrorDetails, MatterErrorType, MatterNetworkError, MatterStorageError, } from './matterTypes.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/matter/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,4BAA4B,EAAE,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,QAAQ,EACR,OAAO,EACP,WAAW,EACX,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,wBAAwB,EACxB,KAAK,YAAY,EACjB,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/matter/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,4BAA4B,EAAE,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,QAAQ,EACR,OAAO,EACP,WAAW,EACX,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,wBAAwB,EACxB,KAAK,YAAY,EACjB,iBAAiB,EACjB,WAAW,EACX,KAAK,kBAAkB,EACvB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,kBAAkB,CAAA"}

package/dist/matter/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/matter/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,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,QAAQ,EACR,OAAO,EACP,WAAW,EAGX,wBAAwB,EAExB,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/matter/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,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,QAAQ,EACR,OAAO,EACP,WAAW,EAKX,wBAAwB,EAExB,iBAAiB,EACjB,WAAW,EAEX,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,kBAAkB,CAAA"}

package/dist/matter/matterAccessoryCache.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 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 { MatterAccessory } from './matterTypes.js';
+/**
+ * Serializable Matter accessory (excludes functions and runtime state)
+ */
+export interface SerializedMatterAccessory {
+    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 saveInProgress;
+    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)
+     */
+    save(accessories: Map<string, MatterAccessory>): 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,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAUvD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,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,cAAc,CAA6B;gBAEvC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAIjD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;IAgD7D;;OAEG;IACG,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBpE;;OAEG;YACW,WAAW;IAqCzB;;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;CAsB3B"}

package/dist/matter/matterAccessoryCache.js

@@ -0,0 +1,168 @@
+/**
+ * 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');
+/**
+ * Matter Accessory Cache Manager
+ */
+export class MatterAccessoryCache {
+    cacheFilePath;
+    cachedAccessories = new Map();
+    cacheLoaded = false;
+    saveInProgress = null;
+    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;
+            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)
+     */
+    async save(accessories) {
+        // Wait for any in-progress save to complete
+        if (this.saveInProgress) {
+            await this.saveInProgress;
+        }
+        // Start new save operation
+        this.saveInProgress = this.performSave(accessories);
+        try {
+            await this.saveInProgress;
+        }
+        finally {
+            this.saveInProgress = null;
+        }
+    }
+    /**
+     * 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
+            const directory = path.dirname(this.cacheFilePath);
+            await fs.ensureDir(directory);
+            // Write to temporary file first (atomic write pattern to prevent corruption)
+            await fs.writeJson(tempFilePath, serialized, { spaces: 2 });
+            // Atomically rename temp file to final location
+            // Use rename for true atomic operation on the same filesystem
+            await fs.rename(tempFilePath, this.cacheFilePath);
+            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 {
+            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,123 @@
+/**
+ * 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;
+    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.
+ */
+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,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;;;;;GAKG;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"}