homebridge 2.0.0-beta.4 → 2.0.0-beta.40

package/dist/api.js

@@ -0,0 +1,223 @@
+import { EventEmitter } from 'node:events';
+import hapNodeJs from 'hap-nodejs';
+import semver from 'semver';
+import { Logger } from './logger.js';
+import { MatterAPIImpl } from './matter/MatterAPIImpl.js';
+import { PlatformAccessory } from './platformAccessory.js';
+import { PluginManager } from './pluginManager.js';
+import { User } from './user.js';
+import getVersion from './version.js';
+const log = Logger.internal;
+// eslint-disable-next-line no-restricted-syntax
+export var PluginType;
+(function (PluginType) {
+    PluginType["ACCESSORY"] = "accessory";
+    PluginType["PLATFORM"] = "platform";
+})(PluginType || (PluginType = {}));
+// eslint-disable-next-line no-restricted-syntax
+export var APIEvent;
+(function (APIEvent) {
+    /**
+     * Event is fired once homebridge has finished with booting up and initializing all components and plugins.
+     * When this event is fired it is possible that the Bridge accessory isn't published yet, if homebridge still needs
+     * to wait for some {@see StaticPlatformPlugin | StaticPlatformPlugins} to finish accessory creation.
+     */
+    APIEvent["DID_FINISH_LAUNCHING"] = "didFinishLaunching";
+    /**
+     * This event is fired when homebridge gets shutdown. This could be a regular shutdown or an unexpected crash.
+     * At this stage all Accessories are already unpublished and all PlatformAccessories are already saved to disk!
+     */
+    APIEvent["SHUTDOWN"] = "shutdown";
+})(APIEvent || (APIEvent = {}));
+// eslint-disable-next-line no-restricted-syntax
+export var InternalAPIEvent;
+(function (InternalAPIEvent) {
+    InternalAPIEvent["REGISTER_ACCESSORY"] = "registerAccessory";
+    InternalAPIEvent["REGISTER_PLATFORM"] = "registerPlatform";
+    InternalAPIEvent["PUBLISH_EXTERNAL_ACCESSORIES"] = "publishExternalAccessories";
+    InternalAPIEvent["REGISTER_PLATFORM_ACCESSORIES"] = "registerPlatformAccessories";
+    InternalAPIEvent["UPDATE_PLATFORM_ACCESSORIES"] = "updatePlatformAccessories";
+    InternalAPIEvent["UNREGISTER_PLATFORM_ACCESSORIES"] = "unregisterPlatformAccessories";
+    // Matter events (matching HAP pattern)
+    InternalAPIEvent["PUBLISH_EXTERNAL_MATTER_ACCESSORIES"] = "publishExternalMatterAccessories";
+    InternalAPIEvent["REGISTER_MATTER_PLATFORM_ACCESSORIES"] = "registerMatterPlatformAccessories";
+    InternalAPIEvent["UPDATE_MATTER_PLATFORM_ACCESSORIES"] = "updateMatterPlatformAccessories";
+    InternalAPIEvent["UNREGISTER_MATTER_PLATFORM_ACCESSORIES"] = "unregisterMatterPlatformAccessories";
+    InternalAPIEvent["UNREGISTER_EXTERNAL_MATTER_ACCESSORIES"] = "unregisterExternalMatterAccessories";
+    InternalAPIEvent["UPDATE_MATTER_ACCESSORY_STATE"] = "updateMatterAccessoryState";
+})(InternalAPIEvent || (InternalAPIEvent = {}));
+// eslint-disable-next-line ts/no-unsafe-declaration-merging
+export class HomebridgeAPI extends EventEmitter {
+    version = 2.7; // homebridge API version
+    serverVersion = getVersion(); // homebridge node module version
+    // ------------------ LEGACY EXPORTS FOR PRE TYPESCRIPT  ------------------
+    user = User;
+    hap = hapNodeJs;
+    hapLegacyTypes = hapNodeJs.LegacyTypes; // used for older accessories/platforms
+    platformAccessory = PlatformAccessory;
+    // ------------------------------------------------------------------------
+    /**
+     * Internal state tracking whether Matter is enabled for this bridge
+     */
+    matterEnabled = false;
+    /**
+     * Internal reference to MatterServer for API methods that need return values
+     * @internal
+     */
+    _matterServer = null;
+    /**
+     * Internal reference to MatterBridgeManager for checking external servers
+     * @internal
+     */
+    _matterManager = null;
+    /**
+     * Pending external accessory registrations
+     * Map of registration ID to resolve function
+     * @internal
+     */
+    _pendingExternalRegistrations = new Map();
+    /**
+     * Lazy-loaded Matter API implementation
+     */
+    _matterAPI;
+    /**
+     * Matter Protocol API (lazy-loaded)
+     * Only instantiated when first accessed
+     */
+    get matter() {
+        if (!this._matterAPI) {
+            this._matterAPI = new MatterAPIImpl(this);
+        }
+        return this._matterAPI;
+    }
+    constructor() {
+        super();
+    }
+    /**
+     * Internal method to set Matter enabled status
+     * Called by Server or ChildBridgeFork after Matter initialization
+     * @internal
+     */
+    _setMatterEnabled(enabled) {
+        this.matterEnabled = enabled;
+    }
+    /**
+     * Internal method to set MatterServer reference
+     * Called by Server or ChildBridgeFork after creating MatterServer
+     * @internal
+     */
+    _setMatterServer(server) {
+        this._matterServer = server;
+    }
+    /**
+     * Internal method to set MatterBridgeManager reference
+     * Called by Server or ChildBridgeFork to allow API access to external servers
+     * @internal
+     */
+    _setMatterManager(manager) {
+        this._matterManager = manager;
+    }
+    /**
+     * Internal method to resolve pending external accessory registrations
+     * Called by MatterBridgeManager when external accessories finish publishing
+     * @internal
+     */
+    _resolveExternalRegistration(registrationId) {
+        const resolve = this._pendingExternalRegistrations.get(registrationId);
+        if (resolve) {
+            resolve();
+            this._pendingExternalRegistrations.delete(registrationId);
+        }
+    }
+    versionGreaterOrEqual(version) {
+        return semver.gte(this.serverVersion, version);
+    }
+    static isDynamicPlatformPlugin(platformPlugin) {
+        return 'configureAccessory' in platformPlugin;
+    }
+    static isStaticPlatformPlugin(platformPlugin) {
+        return 'accessories' in platformPlugin;
+    }
+    signalFinished() {
+        this.emit("didFinishLaunching" /* APIEvent.DID_FINISH_LAUNCHING */);
+    }
+    signalShutdown() {
+        this.emit("shutdown" /* APIEvent.SHUTDOWN */);
+    }
+    registerAccessory(pluginIdentifier, accessoryName, constructor) {
+        if (typeof accessoryName === 'function') {
+            constructor = accessoryName;
+            accessoryName = pluginIdentifier;
+            this.emit("registerAccessory" /* InternalAPIEvent.REGISTER_ACCESSORY */, accessoryName, constructor);
+        }
+        else {
+            this.emit("registerAccessory" /* InternalAPIEvent.REGISTER_ACCESSORY */, accessoryName, constructor, pluginIdentifier);
+        }
+    }
+    registerPlatform(pluginIdentifier, platformName, constructor) {
+        if (typeof platformName === 'function') {
+            constructor = platformName;
+            platformName = pluginIdentifier;
+            this.emit("registerPlatform" /* InternalAPIEvent.REGISTER_PLATFORM */, platformName, constructor);
+        }
+        else {
+            this.emit("registerPlatform" /* InternalAPIEvent.REGISTER_PLATFORM */, platformName, constructor, pluginIdentifier);
+        }
+    }
+    publishCameraAccessories(pluginIdentifier, accessories) {
+        this.publishExternalAccessories(pluginIdentifier, accessories);
+    }
+    publishExternalAccessories(pluginIdentifier, accessories) {
+        if (!PluginManager.isQualifiedPluginIdentifier(pluginIdentifier)) {
+            log.info(`One of your plugins incorrectly registered an external accessory using the platform name (${pluginIdentifier}) and not the plugin identifier. Please report this to the developer!`);
+        }
+        accessories.forEach((accessory) => {
+            // noinspection SuspiciousTypeOfGuard
+            if (!(accessory instanceof PlatformAccessory)) {
+                throw new TypeError(`${pluginIdentifier} attempt to register an accessory that isn't PlatformAccessory!`);
+            }
+            accessory._associatedPlugin = pluginIdentifier;
+        });
+        this.emit("publishExternalAccessories" /* InternalAPIEvent.PUBLISH_EXTERNAL_ACCESSORIES */, accessories);
+    }
+    registerPlatformAccessories(pluginIdentifier, platformName, accessories) {
+        accessories.forEach((accessory) => {
+            // noinspection SuspiciousTypeOfGuard
+            if (!(accessory instanceof PlatformAccessory)) {
+                throw new TypeError(`${pluginIdentifier} - ${platformName} attempt to register an accessory that isn't PlatformAccessory!`);
+            }
+            accessory._associatedPlugin = pluginIdentifier;
+            accessory._associatedPlatform = platformName;
+        });
+        this.emit("registerPlatformAccessories" /* InternalAPIEvent.REGISTER_PLATFORM_ACCESSORIES */, accessories);
+    }
+    updatePlatformAccessories(accessories) {
+        this.emit("updatePlatformAccessories" /* InternalAPIEvent.UPDATE_PLATFORM_ACCESSORIES */, accessories);
+    }
+    unregisterPlatformAccessories(pluginIdentifier, platformName, accessories) {
+        accessories.forEach((accessory) => {
+            // noinspection SuspiciousTypeOfGuard
+            if (!(accessory instanceof PlatformAccessory)) {
+                throw new TypeError(`${pluginIdentifier} - ${platformName} attempt to unregister an accessory that isn't PlatformAccessory!`);
+            }
+        });
+        this.emit("unregisterPlatformAccessories" /* InternalAPIEvent.UNREGISTER_PLATFORM_ACCESSORIES */, accessories);
+    }
+    /**
+     * Check if Matter is available in this version of Homebridge
+     * @returns true if Homebridge version satisfies >= 2.0.0-alpha.0
+     */
+    isMatterAvailable() {
+        return semver.gte(this.serverVersion, '2.0.0-alpha.0');
+    }
+    /**
+     * Check if Matter is enabled for this bridge
+     * For main bridge: returns true if Matter is enabled in `bridge.matter` config
+     * For child bridge: returns true if Matter is enabled in the `_bridge.matter` config
+     * @returns true if Matter is enabled
+     */
+    isMatterEnabled() {
+        return this.matterEnabled;
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/api.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=api.spec.d.ts.map

package/dist/api.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.spec.d.ts","sourceRoot":"","sources":["../src/api.spec.ts"],"names":[],"mappings":""}

package/dist/api.spec.js

@@ -0,0 +1,413 @@
+import { Service } from 'hap-nodejs';
+import { describe, expect, it, vi } from 'vitest';
+import { HomebridgeAPI } from './api.js';
+const api = new HomebridgeAPI();
+const emitSpy = vi.spyOn(api, 'emit');
+class ExampleAccessory {
+    getServices() {
+        return [new Service.Switch('TestSwitch')];
+    }
+}
+class ExamplePlatform {
+    configureAccessory() {
+        // do nothing
+    }
+}
+const pluginName = 'homebridge-example';
+const accessoryName = 'MyCoolAccessory';
+const platformName = 'MyCoolPlatform';
+describe('homebridgeAPI', () => {
+    describe('homebridgeAPI.prototype.registerAccessory', () => {
+        it('should register accessory with legacy style signature', () => {
+            api.registerAccessory(pluginName, accessoryName, ExampleAccessory);
+            expect(emitSpy).toHaveBeenLastCalledWith("registerAccessory" /* InternalAPIEvent.REGISTER_ACCESSORY */, accessoryName, ExampleAccessory, pluginName);
+        });
+        it('should register accessory without passing plugin name', () => {
+            api.registerAccessory(accessoryName, ExampleAccessory);
+            expect(emitSpy).toHaveBeenLastCalledWith("registerAccessory" /* InternalAPIEvent.REGISTER_ACCESSORY */, accessoryName, ExampleAccessory);
+        });
+    });
+    describe('homebridgeAPI.prototype.registerPlatform', () => {
+        it('should register platform with legacy style signature', () => {
+            api.registerPlatform(pluginName, platformName, ExamplePlatform);
+            expect(emitSpy).toHaveBeenLastCalledWith("registerPlatform" /* InternalAPIEvent.REGISTER_PLATFORM */, platformName, ExamplePlatform, pluginName);
+        });
+        it('should register platform without passing plugin name', () => {
+            api.registerPlatform(platformName, ExamplePlatform);
+            expect(emitSpy).toHaveBeenLastCalledWith("registerPlatform" /* InternalAPIEvent.REGISTER_PLATFORM */, platformName, ExamplePlatform);
+        });
+    });
+    describe('matter API', () => {
+        const matterPluginName = 'homebridge-matter-example';
+        const matterPlatformName = 'MatterExamplePlatform';
+        describe('api.matter property access', () => {
+            it('should expose matter API', () => {
+                expect(api.matter).toBeDefined();
+                expect(typeof api.matter).toBe('object');
+            });
+            it('should expose uuid generator (alias of hap.uuid)', () => {
+                expect(api.matter.uuid).toBeDefined();
+                expect(api.matter.uuid).toBe(api.hap.uuid);
+            });
+            it('should expose deviceTypes', () => {
+                expect(api.matter.deviceTypes).toBeDefined();
+                expect(typeof api.matter.deviceTypes).toBe('object');
+            });
+            it('should expose clusters', () => {
+                expect(api.matter.clusters).toBeDefined();
+                expect(typeof api.matter.clusters).toBe('object');
+            });
+            it('should expose clusterNames', () => {
+                expect(api.matter.clusterNames).toBeDefined();
+                expect(typeof api.matter.clusterNames).toBe('object');
+            });
+            it('should expose types', () => {
+                expect(api.matter.types).toBeDefined();
+                expect(typeof api.matter.types).toBe('object');
+            });
+        });
+        describe('api.matter.registerPlatformAccessories', () => {
+            it('should register Matter platform accessories', () => {
+                const matterAccessories = [
+                    {
+                        uuid: api.matter.uuid.generate('test-light-1'),
+                        displayName: 'Test Light 1',
+                        deviceType: api.matter.deviceTypes.OnOffLight,
+                        serialNumber: 'SN-001',
+                        manufacturer: 'Test Manufacturer',
+                        model: 'Test Model',
+                        clusters: {
+                            onOff: {
+                                onOff: false,
+                            },
+                        },
+                    },
+                ];
+                api.matter.registerPlatformAccessories(matterPluginName, matterPlatformName, matterAccessories);
+                expect(emitSpy).toHaveBeenLastCalledWith("registerMatterPlatformAccessories" /* InternalAPIEvent.REGISTER_MATTER_PLATFORM_ACCESSORIES */, matterPluginName, matterPlatformName, matterAccessories);
+            });
+            it('should register multiple Matter platform accessories', () => {
+                const matterAccessories = [
+                    {
+                        uuid: api.matter.uuid.generate('test-light-1'),
+                        displayName: 'Test Light 1',
+                        deviceType: api.matter.deviceTypes.OnOffLight,
+                        serialNumber: 'SN-001',
+                        manufacturer: 'Test',
+                        model: 'Test',
+                        clusters: { onOff: { onOff: false } },
+                    },
+                    {
+                        uuid: api.matter.uuid.generate('test-light-2'),
+                        displayName: 'Test Light 2',
+                        deviceType: api.matter.deviceTypes.DimmableLight,
+                        serialNumber: 'SN-002',
+                        manufacturer: 'Test',
+                        model: 'Test',
+                        clusters: {
+                            onOff: { onOff: true },
+                            levelControl: { currentLevel: 100 },
+                        },
+                    },
+                ];
+                api.matter.registerPlatformAccessories(matterPluginName, matterPlatformName, matterAccessories);
+                expect(emitSpy).toHaveBeenLastCalledWith("registerMatterPlatformAccessories" /* InternalAPIEvent.REGISTER_MATTER_PLATFORM_ACCESSORIES */, matterPluginName, matterPlatformName, matterAccessories);
+            });
+        });
+        describe('api.matter.updatePlatformAccessories', () => {
+            it('should update Matter platform accessories', () => {
+                const matterAccessories = [
+                    {
+                        uuid: api.matter.uuid.generate('test-light-1'),
+                        displayName: 'Updated Light Name',
+                        deviceType: api.matter.deviceTypes.OnOffLight,
+                        serialNumber: 'SN-001',
+                        manufacturer: 'Updated Manufacturer',
+                        model: 'Updated Model',
+                        firmwareRevision: '2.0.0',
+                        clusters: { onOff: { onOff: true } },
+                    },
+                ];
+                api.matter.updatePlatformAccessories(matterAccessories);
+                expect(emitSpy).toHaveBeenLastCalledWith("updateMatterPlatformAccessories" /* InternalAPIEvent.UPDATE_MATTER_PLATFORM_ACCESSORIES */, matterAccessories);
+            });
+            it('should update multiple Matter platform accessories', () => {
+                const matterAccessories = [
+                    {
+                        uuid: api.matter.uuid.generate('test-light-1'),
+                        displayName: 'Light 1 - Updated',
+                        deviceType: api.matter.deviceTypes.OnOffLight,
+                        serialNumber: 'SN-001',
+                        manufacturer: 'Test',
+                        model: 'Test',
+                    },
+                    {
+                        uuid: api.matter.uuid.generate('test-light-2'),
+                        displayName: 'Light 2 - Updated',
+                        deviceType: api.matter.deviceTypes.DimmableLight,
+                        serialNumber: 'SN-002',
+                        manufacturer: 'Test',
+                        model: 'Test',
+                    },
+                ];
+                api.matter.updatePlatformAccessories(matterAccessories);
+                expect(emitSpy).toHaveBeenLastCalledWith("updateMatterPlatformAccessories" /* InternalAPIEvent.UPDATE_MATTER_PLATFORM_ACCESSORIES */, matterAccessories);
+            });
+            it('should handle updating single accessory', () => {
+                const accessory = {
+                    uuid: api.matter.uuid.generate('test-vacuum'),
+                    displayName: 'Kitchen Vacuum - Renamed',
+                    deviceType: api.matter.deviceTypes.RoboticVacuumCleaner,
+                    serialNumber: 'VAC-001',
+                    manufacturer: 'Test',
+                    model: 'V2',
+                    firmwareRevision: '3.1.0',
+                };
+                api.matter.updatePlatformAccessories([accessory]);
+                expect(emitSpy).toHaveBeenLastCalledWith("updateMatterPlatformAccessories" /* InternalAPIEvent.UPDATE_MATTER_PLATFORM_ACCESSORIES */, [accessory]);
+            });
+        });
+        describe('api.matter.unregisterPlatformAccessories', () => {
+            it('should unregister Matter platform accessories', () => {
+                const matterAccessories = [
+                    {
+                        uuid: api.matter.uuid.generate('test-light-1'),
+                        displayName: 'Test Light 1',
+                        deviceType: api.matter.deviceTypes.OnOffLight,
+                        serialNumber: 'SN-001',
+                        manufacturer: 'Test',
+                        model: 'Test',
+                    },
+                ];
+                api.matter.unregisterPlatformAccessories(matterPluginName, matterPlatformName, matterAccessories);
+                expect(emitSpy).toHaveBeenLastCalledWith("unregisterMatterPlatformAccessories" /* InternalAPIEvent.UNREGISTER_MATTER_PLATFORM_ACCESSORIES */, matterPluginName, matterPlatformName, matterAccessories);
+            });
+            it('should unregister multiple Matter platform accessories', () => {
+                const matterAccessories = [
+                    {
+                        uuid: api.matter.uuid.generate('test-light-1'),
+                        displayName: 'Light 1',
+                        deviceType: api.matter.deviceTypes.OnOffLight,
+                        serialNumber: 'SN-001',
+                        manufacturer: 'Test',
+                        model: 'Test',
+                    },
+                    {
+                        uuid: api.matter.uuid.generate('test-light-2'),
+                        displayName: 'Light 2',
+                        deviceType: api.matter.deviceTypes.OnOffLight,
+                        serialNumber: 'SN-002',
+                        manufacturer: 'Test',
+                        model: 'Test',
+                    },
+                ];
+                api.matter.unregisterPlatformAccessories(matterPluginName, matterPlatformName, matterAccessories);
+                expect(emitSpy).toHaveBeenLastCalledWith("unregisterMatterPlatformAccessories" /* InternalAPIEvent.UNREGISTER_MATTER_PLATFORM_ACCESSORIES */, matterPluginName, matterPlatformName, matterAccessories);
+            });
+            it('should automatically unregister RoboticVacuumCleaner as external accessory', () => {
+                const vacuumAccessory = {
+                    uuid: api.matter.uuid.generate('test-vacuum-1'),
+                    displayName: 'Test Vacuum',
+                    deviceType: api.matter.deviceTypes.RoboticVacuumCleaner,
+                    serialNumber: 'SN-VAC-001',
+                    manufacturer: 'Test',
+                    model: 'Test',
+                };
+                api.matter.unregisterPlatformAccessories(matterPluginName, matterPlatformName, [vacuumAccessory]);
+                expect(emitSpy).toHaveBeenLastCalledWith("unregisterExternalMatterAccessories" /* InternalAPIEvent.UNREGISTER_EXTERNAL_MATTER_ACCESSORIES */, [vacuumAccessory]);
+            });
+            it('should split unregister into normal and external based on device type', () => {
+                emitSpy.mockClear();
+                const mixedAccessories = [
+                    {
+                        uuid: api.matter.uuid.generate('test-light-1'),
+                        displayName: 'Light 1',
+                        deviceType: api.matter.deviceTypes.OnOffLight,
+                        serialNumber: 'SN-001',
+                        manufacturer: 'Test',
+                        model: 'Test',
+                    },
+                    {
+                        uuid: api.matter.uuid.generate('test-vacuum-1'),
+                        displayName: 'Vacuum 1',
+                        deviceType: api.matter.deviceTypes.RoboticVacuumCleaner,
+                        serialNumber: 'SN-002',
+                        manufacturer: 'Test',
+                        model: 'Test',
+                    },
+                    {
+                        uuid: api.matter.uuid.generate('test-light-2'),
+                        displayName: 'Light 2',
+                        deviceType: api.matter.deviceTypes.DimmableLight,
+                        serialNumber: 'SN-003',
+                        manufacturer: 'Test',
+                        model: 'Test',
+                    },
+                ];
+                api.matter.unregisterPlatformAccessories(matterPluginName, matterPlatformName, mixedAccessories);
+                expect(emitSpy).toHaveBeenCalledTimes(2);
+                const calls = emitSpy.mock.calls;
+                const unregisterCall = calls.find(call => call[0] === "unregisterMatterPlatformAccessories" /* InternalAPIEvent.UNREGISTER_MATTER_PLATFORM_ACCESSORIES */);
+                const unregisterExternalCall = calls.find(call => call[0] === "unregisterExternalMatterAccessories" /* InternalAPIEvent.UNREGISTER_EXTERNAL_MATTER_ACCESSORIES */);
+                expect(unregisterCall).toBeDefined();
+                expect(unregisterCall[3]).toHaveLength(2);
+                expect(unregisterCall[3][0].displayName).toBe('Light 1');
+                expect(unregisterCall[3][1].displayName).toBe('Light 2');
+                expect(unregisterExternalCall).toBeDefined();
+                expect(unregisterExternalCall[1]).toHaveLength(1);
+                expect(unregisterExternalCall[1][0].displayName).toBe('Vacuum 1');
+            });
+        });
+        describe('registerPlatformAccessories - external device handling', () => {
+            it('should automatically publish RoboticVacuumCleaner as external accessory', () => {
+                const vacuumAccessory = {
+                    uuid: api.matter.uuid.generate('test-vacuum-1'),
+                    displayName: 'Test Vacuum',
+                    deviceType: api.matter.deviceTypes.RoboticVacuumCleaner,
+                    serialNumber: 'SN-VAC-001',
+                    manufacturer: 'Test Manufacturer',
+                    model: 'Vacuum Model',
+                    clusters: {
+                        onOff: { onOff: false },
+                        rvcRunMode: { currentMode: 0 },
+                    },
+                };
+                api.matter.registerPlatformAccessories(matterPluginName, matterPlatformName, [vacuumAccessory]);
+                expect(emitSpy).toHaveBeenLastCalledWith("publishExternalMatterAccessories" /* InternalAPIEvent.PUBLISH_EXTERNAL_MATTER_ACCESSORIES */, expect.arrayContaining([
+                    expect.objectContaining({
+                        uuid: vacuumAccessory.uuid,
+                        displayName: 'Test Vacuum',
+                        _associatedPlugin: matterPluginName,
+                    }),
+                ]), expect.any(String));
+            });
+            it('should split accessories into normal and external based on device type', () => {
+                emitSpy.mockClear();
+                const mixedAccessories = [
+                    {
+                        uuid: api.matter.uuid.generate('test-light-1'),
+                        displayName: 'Light 1',
+                        deviceType: api.matter.deviceTypes.OnOffLight,
+                        serialNumber: 'SN-001',
+                        manufacturer: 'Test',
+                        model: 'Test',
+                    },
+                    {
+                        uuid: api.matter.uuid.generate('test-vacuum-1'),
+                        displayName: 'Vacuum 1',
+                        deviceType: api.matter.deviceTypes.RoboticVacuumCleaner,
+                        serialNumber: 'SN-002',
+                        manufacturer: 'Test',
+                        model: 'Test',
+                    },
+                    {
+                        uuid: api.matter.uuid.generate('test-light-2'),
+                        displayName: 'Light 2',
+                        deviceType: api.matter.deviceTypes.DimmableLight,
+                        serialNumber: 'SN-003',
+                        manufacturer: 'Test',
+                        model: 'Test',
+                    },
+                ];
+                api.matter.registerPlatformAccessories(matterPluginName, matterPlatformName, mixedAccessories);
+                expect(emitSpy).toHaveBeenCalledTimes(2);
+                const calls = emitSpy.mock.calls;
+                const registerCall = calls.find(call => call[0] === "registerMatterPlatformAccessories" /* InternalAPIEvent.REGISTER_MATTER_PLATFORM_ACCESSORIES */);
+                const publishCall = calls.find(call => call[0] === "publishExternalMatterAccessories" /* InternalAPIEvent.PUBLISH_EXTERNAL_MATTER_ACCESSORIES */);
+                expect(registerCall).toBeDefined();
+                expect(registerCall[3]).toHaveLength(2);
+                expect(registerCall[3][0].displayName).toBe('Light 1');
+                expect(registerCall[3][1].displayName).toBe('Light 2');
+                expect(publishCall).toBeDefined();
+                expect(publishCall[1]).toHaveLength(1);
+                expect(publishCall[1][0].displayName).toBe('Vacuum 1');
+            });
+        });
+        describe('api.matter.updateAccessoryState', () => {
+            it('should update Matter accessory state', () => {
+                const uuid = api.matter.uuid.generate('test-light-update');
+                const cluster = api.matter.clusterNames.OnOff;
+                const attributes = { onOff: true };
+                api.matter.updateAccessoryState(uuid, cluster, attributes);
+                expect(emitSpy).toHaveBeenLastCalledWith("updateMatterAccessoryState" /* InternalAPIEvent.UPDATE_MATTER_ACCESSORY_STATE */, uuid, cluster, attributes, undefined);
+            });
+            it('should update Matter accessory state for specific part', () => {
+                const uuid = api.matter.uuid.generate('test-power-strip');
+                const cluster = api.matter.clusterNames.OnOff;
+                const attributes = { onOff: true };
+                const partId = 'outlet-2';
+                api.matter.updateAccessoryState(uuid, cluster, attributes, partId);
+                expect(emitSpy).toHaveBeenLastCalledWith("updateMatterAccessoryState" /* InternalAPIEvent.UPDATE_MATTER_ACCESSORY_STATE */, uuid, cluster, attributes, partId);
+            });
+            it('should update different cluster types', () => {
+                const uuid = api.matter.uuid.generate('test-dimmable-light');
+                // Update OnOff cluster
+                api.matter.updateAccessoryState(uuid, api.matter.clusterNames.OnOff, { onOff: true });
+                expect(emitSpy).toHaveBeenCalledWith("updateMatterAccessoryState" /* InternalAPIEvent.UPDATE_MATTER_ACCESSORY_STATE */, uuid, api.matter.clusterNames.OnOff, { onOff: true }, undefined);
+                // Update LevelControl cluster
+                api.matter.updateAccessoryState(uuid, api.matter.clusterNames.LevelControl, { currentLevel: 200 });
+                expect(emitSpy).toHaveBeenLastCalledWith("updateMatterAccessoryState" /* InternalAPIEvent.UPDATE_MATTER_ACCESSORY_STATE */, uuid, api.matter.clusterNames.LevelControl, { currentLevel: 200 }, undefined);
+            });
+        });
+        describe('api.matter.getAccessoryState', () => {
+            it('should have getAccessoryState method', () => {
+                expect(typeof api.matter.getAccessoryState).toBe('function');
+            });
+            it('should accept uuid and cluster parameters', () => {
+                const uuid = api.matter.uuid.generate('test-light-get');
+                const cluster = api.matter.clusterNames.OnOff;
+                // Just verify it can be called without error
+                // Actual state retrieval requires MatterServer to be running
+                expect(() => api.matter.getAccessoryState(uuid, cluster)).not.toThrow();
+            });
+            it('should accept optional partId parameter', () => {
+                const uuid = api.matter.uuid.generate('test-power-strip-get');
+                const cluster = api.matter.clusterNames.OnOff;
+                const partId = 'outlet-1';
+                expect(() => api.matter.getAccessoryState(uuid, cluster, partId)).not.toThrow();
+            });
+        });
+        describe('matter cluster names', () => {
+            it('should include common cluster names', () => {
+                expect(api.matter.clusterNames.OnOff).toBe('onOff');
+                expect(api.matter.clusterNames.LevelControl).toBe('levelControl');
+                expect(api.matter.clusterNames.ColorControl).toBe('colorControl');
+                expect(api.matter.clusterNames.DoorLock).toBe('doorLock');
+                expect(api.matter.clusterNames.Thermostat).toBe('thermostat');
+                expect(api.matter.clusterNames.WindowCovering).toBe('windowCovering');
+                expect(api.matter.clusterNames.FanControl).toBe('fanControl');
+            });
+            it('should include RVC cluster names', () => {
+                expect(api.matter.clusterNames.RvcRunMode).toBe('rvcRunMode');
+                expect(api.matter.clusterNames.RvcCleanMode).toBe('rvcCleanMode');
+                expect(api.matter.clusterNames.RvcOperationalState).toBe('rvcOperationalState');
+                expect(api.matter.clusterNames.ServiceArea).toBe('serviceArea');
+            });
+        });
+        describe('matter device types', () => {
+            it('should include common device types', () => {
+                expect(api.matter.deviceTypes.OnOffLight).toBeDefined();
+                expect(api.matter.deviceTypes.DimmableLight).toBeDefined();
+                expect(api.matter.deviceTypes.ColorTemperatureLight).toBeDefined();
+                expect(api.matter.deviceTypes.ExtendedColorLight).toBeDefined();
+                expect(api.matter.deviceTypes.OnOffOutlet).toBeDefined();
+                expect(api.matter.deviceTypes.OnOffSwitch).toBeDefined();
+                expect(api.matter.deviceTypes.DoorLock).toBeDefined();
+                expect(api.matter.deviceTypes.Thermostat).toBeDefined();
+                expect(api.matter.deviceTypes.WindowCovering).toBeDefined();
+                expect(api.matter.deviceTypes.Fan).toBeDefined();
+            });
+            it('should include specialized device types', () => {
+                expect(api.matter.deviceTypes.RoboticVacuumCleaner).toBeDefined();
+                expect(api.matter.deviceTypes.ContactSensor).toBeDefined();
+                expect(api.matter.deviceTypes.LightSensor).toBeDefined();
+                expect(api.matter.deviceTypes.MotionSensor).toBeDefined();
+                expect(api.matter.deviceTypes.TemperatureSensor).toBeDefined();
+                expect(api.matter.deviceTypes.HumiditySensor).toBeDefined();
+                expect(api.matter.deviceTypes.LeakSensor).toBeDefined();
+                expect(api.matter.deviceTypes.SmokeSensor).toBeDefined();
+            });
+        });
+    });
+});
+//# sourceMappingURL=api.spec.js.map