homebridge 2.0.0-beta.30 → 2.0.0-beta.32

package/dist/matter/index.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Matter Protocol Support for Homebridge
+ *
+ * This module provides Matter protocol support through a Plugin API,
+ * allowing plugin developers to explicitly register Matter accessories.
+ */
+import type { ColorControl, DoorLock, FanControl, Groups, Identify, LevelControl, ModeBase, OnOff, ScenesManagement, ServiceArea, Thermostat, WindowCovering } from '@matter/main/clusters';
+export { type MatterConfigValidationResult, MatterConfigValidator } from './matterConfigValidator.js';
+export { MatterServer } from './matterServer.js';
+export { HomebridgeMatterStorage, MatterStorageManager } from './matterStorage.js';
+export { clusterNames, clusters, devices, deviceTypes, type InternalMatterAccessory, type MatterAccessory, type MatterAccessoryEventEmitter, MatterAccessoryEventTypes, type MatterClusterHandlers, type MatterClusterName, type MatterCommandHandler, MatterCommissioningError, type MatterConfig, MatterDeviceError, MatterError, type MatterErrorDetails, MatterErrorType, MatterNetworkError, MatterStorageError, } from './matterTypes.js';
+/**
+ * Matter Cluster Command Request Types
+ * Use these types for handler arguments to get full type safety
+ *
+ * @example
+ * ```typescript
+ * import type { MatterRequests } from 'homebridge'
+ *
+ * handlers: {
+ *   levelControl: {
+ *     moveToLevel: async (args: MatterRequests.MoveToLevel) => {
+ *       console.log(`Level: ${args.level}`)
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare namespace MatterRequests {
+    type OffWithEffect = OnOff.OffWithEffectRequest;
+    type OnWithTimedOff = OnOff.OnWithTimedOffRequest;
+    type MoveToLevel = LevelControl.MoveToLevelRequest;
+    type Move = LevelControl.MoveRequest;
+    type Step = LevelControl.StepRequest;
+    type Stop = LevelControl.StopRequest;
+    type MoveToClosestFrequency = LevelControl.MoveToClosestFrequencyRequest;
+    type MoveToHue = ColorControl.MoveToHueRequest;
+    type MoveHue = ColorControl.MoveHueRequest;
+    type StepHue = ColorControl.StepHueRequest;
+    type MoveToSaturation = ColorControl.MoveToSaturationRequest;
+    type MoveSaturation = ColorControl.MoveSaturationRequest;
+    type StepSaturation = ColorControl.StepSaturationRequest;
+    type MoveToHueAndSaturation = ColorControl.MoveToHueAndSaturationRequest;
+    type MoveToColor = ColorControl.MoveToColorRequest;
+    type MoveColor = ColorControl.MoveColorRequest;
+    type StepColor = ColorControl.StepColorRequest;
+    type MoveToColorTemperature = ColorControl.MoveToColorTemperatureRequest;
+    type MoveColorTemperature = ColorControl.MoveColorTemperatureRequest;
+    type StepColorTemperature = ColorControl.StepColorTemperatureRequest;
+    type StopMoveStep = ColorControl.StopMoveStepRequest;
+    type EnhancedMoveToHue = ColorControl.EnhancedMoveToHueRequest;
+    type EnhancedMoveHue = ColorControl.EnhancedMoveHueRequest;
+    type EnhancedStepHue = ColorControl.EnhancedStepHueRequest;
+    type EnhancedMoveToHueAndSaturation = ColorControl.EnhancedMoveToHueAndSaturationRequest;
+    type ColorLoopSet = ColorControl.ColorLoopSetRequest;
+    type IdentifyRequest = Identify.IdentifyRequest;
+    type TriggerEffect = Identify.TriggerEffectRequest;
+    type AddGroup = Groups.AddGroupRequest;
+    type ViewGroup = Groups.ViewGroupRequest;
+    type GetGroupMembership = Groups.GetGroupMembershipRequest;
+    type RemoveGroup = Groups.RemoveGroupRequest;
+    type AddGroupIfIdentifying = Groups.AddGroupIfIdentifyingRequest;
+    type AddScene = ScenesManagement.AddSceneRequest;
+    type ViewScene = ScenesManagement.ViewSceneRequest;
+    type RemoveScene = ScenesManagement.RemoveSceneRequest;
+    type RemoveAllScenes = ScenesManagement.RemoveAllScenesRequest;
+    type StoreScene = ScenesManagement.StoreSceneRequest;
+    type RecallScene = ScenesManagement.RecallSceneRequest;
+    type GetSceneMembership = ScenesManagement.GetSceneMembershipRequest;
+    type CopyScene = ScenesManagement.CopySceneRequest;
+    type LockDoor = DoorLock.LockDoorRequest;
+    type UnlockDoor = DoorLock.UnlockDoorRequest;
+    type UnlockWithTimeout = DoorLock.UnlockWithTimeoutRequest;
+    type UnboltDoor = DoorLock.UnboltDoorRequest;
+    type SetUser = DoorLock.SetUserRequest;
+    type GetUser = DoorLock.GetUserRequest;
+    type ClearUser = DoorLock.ClearUserRequest;
+    type SetUserStatus = DoorLock.SetUserStatusRequest;
+    type GetUserStatus = DoorLock.GetUserStatusRequest;
+    type SetUserType = DoorLock.SetUserTypeRequest;
+    type GetUserType = DoorLock.GetUserTypeRequest;
+    type SetCredential = DoorLock.SetCredentialRequest;
+    type GetCredentialStatus = DoorLock.GetCredentialStatusRequest;
+    type ClearCredential = DoorLock.ClearCredentialRequest;
+    type SetPinCode = DoorLock.SetPinCodeRequest;
+    type GetPinCode = DoorLock.GetPinCodeRequest;
+    type ClearPinCode = DoorLock.ClearPinCodeRequest;
+    type SetRfidCode = DoorLock.SetRfidCodeRequest;
+    type GetRfidCode = DoorLock.GetRfidCodeRequest;
+    type ClearRfidCode = DoorLock.ClearRfidCodeRequest;
+    type SetWeekDaySchedule = DoorLock.SetWeekDayScheduleRequest;
+    type GetWeekDaySchedule = DoorLock.GetWeekDayScheduleRequest;
+    type ClearWeekDaySchedule = DoorLock.ClearWeekDayScheduleRequest;
+    type SetYearDaySchedule = DoorLock.SetYearDayScheduleRequest;
+    type GetYearDaySchedule = DoorLock.GetYearDayScheduleRequest;
+    type ClearYearDaySchedule = DoorLock.ClearYearDayScheduleRequest;
+    type SetHolidaySchedule = DoorLock.SetHolidayScheduleRequest;
+    type GetHolidaySchedule = DoorLock.GetHolidayScheduleRequest;
+    type ClearHolidaySchedule = DoorLock.ClearHolidayScheduleRequest;
+    type SetAliroReaderConfig = DoorLock.SetAliroReaderConfigRequest;
+    type GoToLiftPercentage = WindowCovering.GoToLiftPercentageRequest;
+    type GoToTiltPercentage = WindowCovering.GoToTiltPercentageRequest;
+    type GoToLiftValue = WindowCovering.GoToLiftValueRequest;
+    type GoToTiltValue = WindowCovering.GoToTiltValueRequest;
+    type SetpointRaiseLower = Thermostat.SetpointRaiseLowerRequest;
+    type SetActivePreset = Thermostat.SetActivePresetRequest;
+    type SetActiveSchedule = Thermostat.SetActiveScheduleRequest;
+    type GetWeeklySchedule = Thermostat.GetWeeklyScheduleRequest;
+    type SetWeeklySchedule = Thermostat.SetWeeklyScheduleRequest;
+    type FanStep = FanControl.StepRequest;
+    type ChangeToMode = ModeBase.ChangeToModeRequest;
+    type SelectAreas = ServiceArea.SelectAreasRequest;
+    type SkipArea = ServiceArea.SkipAreaRequest;
+}
+/**
+ * Matter Cluster Types & Enums
+ * Import these to access type-safe enum values for cluster attributes using the original matter.js names.
+ *
+ * All 130+ Matter clusters are exported here with their original matter.js names, providing access to
+ * enums, types, and constants with full TypeScript autocomplete support.
+ */
+export * as MatterTypes from '@matter/main/clusters';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/matter/index.js

@@ -0,0 +1,19 @@
+/**
+ * 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, MatterAccessoryEventTypes, MatterCommissioningError, MatterDeviceError, MatterError, MatterErrorType, MatterNetworkError, MatterStorageError, } from './matterTypes.js';
+/**
+ * Matter Cluster Types & Enums
+ * Import these to access type-safe enum values for cluster attributes using the original matter.js names.
+ *
+ * All 130+ Matter clusters are exported here with their original matter.js names, providing access to
+ * enums, types, and constants with full TypeScript autocomplete support.
+ */
+export * as MatterTypes from '@matter/main/clusters';
+//# 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;AAkBH,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,EAIX,yBAAyB,EAIzB,wBAAwB,EAExB,iBAAiB,EACjB,WAAW,EAEX,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,kBAAkB,CAAA;AA0KzB;;;;;;GAMG;AACH,OAAO,KAAK,WAAW,MAAM,uBAAuB,CAAA"}

package/dist/matter/matterAccessoryCache.d.ts

@@ -0,0 +1,96 @@
+/**
+ * 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 part (excludes functions and runtime state)
+ */
+export interface SerializedMatterAccessoryPart {
+    id: string;
+    displayName?: string;
+    deviceType: {
+        name?: string;
+        code?: number;
+    };
+    clusters: {
+        [clusterName: string]: {
+            [attributeName: string]: unknown;
+        };
+    };
+}
+/**
+ * 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, unknown>;
+    clusters?: {
+        [clusterName: string]: {
+            [attributeName: string]: unknown;
+        };
+    };
+    parts?: SerializedMatterAccessoryPart[];
+}
+/**
+ * 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
+     * Returns a map of cached accessories keyed by UUID
+     */
+    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
+     * Performs atomic write to prevent cache corruption on system crashes
+     */
+    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,6BAA6B;IAC5C,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE;QACV,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;IACD,QAAQ,EAAE;QACR,CAAC,WAAW,EAAE,MAAM,GAAG;YACrB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAA;SACjC,CAAA;KACF,CAAA;CACF;AAED;;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,OAAO,CAAC,CAAA;IACjC,QAAQ,CAAC,EAAE;QACT,CAAC,WAAW,EAAE,MAAM,GAAG;YACrB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAA;SACjC,CAAA;KACF,CAAA;IACD,KAAK,CAAC,EAAE,6BAA6B,EAAE,CAAA;CACxC;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;;;OAGG;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;;;OAGG;YACW,WAAW;IA8CzB;;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;CA0C3B"}

package/dist/matter/matterAccessoryCache.js

@@ -0,0 +1,192 @@
+/**
+ * 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 { dirname, join } 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 = join(storagePath, bridgeId, 'accessories.json');
+    }
+    /**
+     * Load cached accessories from disk
+     * Returns a map of cached accessories keyed by UUID
+     */
+    async load() {
+        if (this.cacheLoaded) {
+            return this.cachedAccessories;
+        }
+        try {
+            // Check if 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)) {
+                throw new TypeError('Cache file does not contain an array');
+            }
+            // Load accessories into map (only those with valid UUIDs)
+            for (const serialized of cacheData) {
+                if (serialized.uuid) {
+                    this.cachedAccessories.set(serialized.uuid, serialized);
+                }
+            }
+            log.info(`Loaded ${this.cachedAccessories.size} cached Matter accessories`);
+            // Directory must exist if we successfully loaded the cache file
+            this.directoryEnsured = true;
+            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 from ${this.cacheFilePath}: ${error.message}`);
+            log.warn('Deleting corrupted cache file and starting fresh');
+            try {
+                await fs.remove(this.cacheFilePath);
+            }
+            catch (removeError) {
+                // non-fatal: couldn't delete corrupted file
+                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
+     * Performs atomic write to prevent cache corruption on system crashes
+     */
+    async performSave(accessories) {
+        const tempFilePath = `${this.cacheFilePath}.tmp`;
+        try {
+            // Serialize accessories (strip out functions and non-serializable objects)
+            const serialized = Array.from(accessories.values())
+                .map(accessory => this.serializeAccessory(accessory));
+            // Ensure directory exists (only check once, not on every save)
+            if (!this.directoryEnsured) {
+                const directory = 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 accessor${serialized.length === 1 ? 'y' : 'ies'} 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) {
+                // non-fatal: couldn't clean up temp file
+                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 (EndpointType has name and code properties)
+        const deviceType = accessory.deviceType;
+        const deviceTypeInfo = {
+            name: deviceType?.name,
+            code: deviceType?.code,
+        };
+        // Serialize parts if present (excluding handlers which are functions)
+        let serializedParts;
+        if (accessory.parts && accessory.parts.length > 0) {
+            serializedParts = accessory.parts.map((part) => {
+                const partDeviceType = part.deviceType;
+                return {
+                    id: part.id,
+                    displayName: part.displayName,
+                    deviceType: {
+                        name: partDeviceType?.name,
+                        code: partDeviceType?.code,
+                    },
+                    clusters: structuredClone(part.clusters),
+                };
+            });
+        }
+        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),
+            parts: serializedParts,
+        };
+    }
+}
+//# 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,194 @@
+/**
+ * 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 { MaybePromise } from '@matter/main';
+import type { ColorControl, Identify, LevelControl, ServiceArea, Thermostat, WindowCovering } from '@matter/main/clusters';
+import type { MatterAccessoryMap, MatterCommandHandler } from './matterTypes.js';
+import { ColorControlServer, DoorLockServer, FanControlServer, IdentifyServer, LevelControlServer, OnOffServer, RvcCleanModeServer, RvcOperationalStateServer, RvcRunModeServer, ServiceAreaServer, ThermostatServer, WindowCoveringBaseServer } from '@matter/main/behaviors';
+import { RvcOperationalState } from '@matter/main/clusters';
+/**
+ * Result type for Matter commands
+ * MaybePromise allows both sync and async returns, matching Matter.js base classes
+ */
+type MatterCommandResult = MaybePromise<void>;
+/**
+ * Set the accessories map reference for cache syncing
+ */
+export declare function setAccessoriesMap(map: MatterAccessoryMap): void;
+/**
+ * Register a part endpoint mapping
+ * This associates a part endpoint ID with its parent accessory UUID and part ID
+ *
+ * @param endpointId - The endpoint ID (e.g., '{parentUuid}-part-{partId}')
+ * @param parentUuid - The parent accessory UUID
+ * @param partId - The part identifier within the parent
+ */
+export declare function registerPartEndpoint(endpointId: string, parentUuid: string, partId: string): 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(): MatterCommandResult;
+    off(): MatterCommandResult;
+    toggle(): MatterCommandResult;
+}
+/**
+ * Custom LevelControl Server that calls plugin handlers
+ */
+export declare class HomebridgeLevelControlServer extends LevelControlServer {
+    moveToLevel(request: LevelControl.MoveToLevelRequest): MatterCommandResult;
+    moveToLevelWithOnOff(request: LevelControl.MoveToLevelRequest): MaybePromise;
+    move(request: LevelControl.MoveRequest): MaybePromise;
+    step(request: LevelControl.StepRequest): MaybePromise;
+    stop(request: LevelControl.StopRequest): MaybePromise;
+}
+/**
+ * Custom WindowCovering Server that calls plugin handlers
+ */
+export declare class HomebridgeWindowCoveringServer extends WindowCoveringBaseServer {
+    /**
+     * Sync window covering position state to cache
+     * @param endpointId - The endpoint ID
+     * @param targetProperty - Target position property name (e.g., 'targetPositionLiftPercent100ths')
+     * @param currentProperty - Current position property name (e.g., 'currentPositionLiftPercent100ths')
+     */
+    private syncPositionStateToCache;
+    upOrOpen(): MaybePromise;
+    downOrClose(): MaybePromise;
+    stopMotion(): MaybePromise;
+    goToLiftPercentage(request: WindowCovering.GoToLiftPercentageRequest): MaybePromise;
+    goToTiltPercentage(request: WindowCovering.GoToTiltPercentageRequest): MaybePromise;
+}
+/**
+ * Custom FanControl Server that calls plugin handlers
+ */
+export declare class HomebridgeFanControlServer extends FanControlServer {
+    #private;
+    initialize(): void;
+}
+/**
+ * Custom DoorLock Server that calls plugin handlers
+ */
+export declare class HomebridgeDoorLockServer extends DoorLockServer {
+    lockDoor(): MaybePromise;
+    unlockDoor(): MaybePromise;
+}
+/**
+ * Custom Thermostat Server that calls plugin handlers
+ */
+export declare class HomebridgeThermostatServer extends ThermostatServer {
+    #private;
+    initialize(): void;
+    setpointRaiseLower(request: Thermostat.SetpointRaiseLowerRequest): MaybePromise;
+}
+/**
+ * Custom Identify Server that calls plugin handlers
+ */
+export declare class HomebridgeIdentifyServer extends IdentifyServer {
+    identify(request: Identify.IdentifyRequest): MaybePromise;
+}
+/**
+ * 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 colorTemperatureMireds - Target color temperature in mireds (micro reciprocal degrees)
+     * @param transitionTime - Transition time in seconds (0 = as fast as possible)
+     */
+    moveToColorTemperatureLogic(colorTemperatureMireds: number, transitionTime: number): MaybePromise;
+    /**
+     * Called when hue and saturation are changed together
+     * @param hue - Target hue value (0-254 for normal hue, 0-65535 for enhanced hue)
+     * @param saturation - Target saturation value (0-254)
+     * @param transitionTime - Transition time in seconds (0 = as fast as possible)
+     */
+    moveToHueAndSaturationLogic(hue: number, saturation: number, transitionTime: number): MaybePromise;
+    /**
+     * 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): MaybePromise;
+    /**
+     * 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: ColorControl.Direction, transitionTime: number, isEnhancedHue?: boolean): MaybePromise;
+    /**
+     * Called when saturation is changed individually
+     * @param targetSaturation - Target saturation value (0-254)
+     * @param transitionTime - Transition time in seconds
+     */
+    moveToSaturationLogic(targetSaturation: number, transitionTime: number): MaybePromise;
+    /**
+     * Called when all color movement should be stopped
+     */
+    stopAllColorMovement(): MaybePromise;
+}
+/**
+ * Custom RvcOperationalState Server that calls plugin handlers
+ * Handles robotic vacuum cleaner operational state commands
+ */
+export declare class HomebridgeRvcOperationalStateServer extends RvcOperationalStateServer {
+    pause(): MaybePromise<RvcOperationalState.OperationalCommandResponse>;
+    resume(): MaybePromise<RvcOperationalState.OperationalCommandResponse>;
+    goHome(): MaybePromise<RvcOperationalState.OperationalCommandResponse>;
+}
+/**
+ * Custom RvcRunMode Server that calls plugin handlers
+ * Handles robotic vacuum cleaner run mode changes
+ */
+export declare class HomebridgeRvcRunModeServer extends RvcRunModeServer {
+    changeToMode(request: any): any;
+}
+/**
+ * Custom RvcCleanMode Server that calls plugin handlers
+ * Handles robotic vacuum cleaner cleaning mode changes
+ */
+export declare class HomebridgeRvcCleanModeServer extends RvcCleanModeServer {
+    changeToMode(request: any): any;
+}
+/**
+ * Custom ServiceArea Server that calls plugin handlers
+ * Handles service area selection for robotic vacuum cleaners
+ */
+export declare class HomebridgeServiceAreaServer extends ServiceAreaServer {
+    selectAreas(request: ServiceArea.SelectAreasRequest): MaybePromise<ServiceArea.SelectAreasResponse>;
+    skipArea(request: ServiceArea.SkipAreaRequest): MaybePromise<ServiceArea.SkipAreaResponse>;
+}
+export {};
+//# 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":"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"}