@switchbot/homebridge-switchbot 5.0.0-beta.3 → 5.0.0-beta.30

package/dist/test/platform-matter.cleanup.test.js

@@ -0,0 +1,70 @@
+import { describe, expect, it, vi } from 'vitest';
+import { SwitchBotMatterPlatform } from '../platform-matter.js';
+import { formatDeviceIdAsMac } from '../utils.js';
+import { makeApiStub, makeLogStub } from './helpers/platform-fixtures.js';
+describe('platform-matter lifecycle cleanup', () => {
+    it('clearDeviceResources removes timers, instances and BLE handler entries', async () => {
+        // Setup stubbed API and logs
+        const handlers = {};
+        const api = makeApiStub({ registerPlatformAccessories: vi.fn(), unregisterPlatformAccessories: vi.fn(), clusterNames: { OnOff: 'OnOff' } });
+        api._handlers = handlers;
+        // keep api.on as a single-statement arrow to satisfy lint
+        api.on = (ev, fn) => (handlers[ev] = fn);
+        const log = makeLogStub();
+        const platform = new SwitchBotMatterPlatform(log, {}, api);
+        // Insert a fake timer, accessory instance, and BLE handler
+        const deviceId = 'AA:BB:CC:11:22:33';
+        const nid = platform.normalizeDeviceId(deviceId);
+        const timer = setInterval(() => { }, 100000);
+        platform.refreshTimers.set(nid, timer);
+        platform.accessoryInstances.set(nid, { dummy: true });
+        platform.bleEventHandler[deviceId.toLowerCase()] = () => { };
+        // Ensure they exist prior
+        expect(platform.refreshTimers.get(nid)).toBeDefined();
+        expect(platform.accessoryInstances.get(nid)).toBeDefined();
+        expect(platform.bleEventHandler[deviceId.toLowerCase()]).toBeDefined();
+        platform.clearDeviceResources(deviceId);
+        // Now they should be removed
+        expect(platform.refreshTimers.get(nid)).toBeUndefined();
+        expect(platform.accessoryInstances.get(nid)).toBeUndefined();
+        expect(platform.bleEventHandler[deviceId.toLowerCase()]).toBeUndefined();
+    });
+    it('shutdown handler clears all timers and handlers when invoked', async () => {
+        // Setup stubbed API and logs
+        const handlers = {};
+        const api = makeApiStub({ registerPlatformAccessories: vi.fn(), unregisterPlatformAccessories: vi.fn(), clusterNames: { OnOff: 'OnOff' } });
+        api._handlers = handlers;
+        // keep api.on as a single-statement arrow to satisfy lint
+        api.on = (ev, fn) => (handlers[ev] = fn);
+        const log = makeLogStub();
+        const platform = new SwitchBotMatterPlatform(log, {}, api);
+        // Add two timers to the platform (using normalized ids)
+        const ids = ['devA', 'devB'];
+        for (const id of ids) {
+            const nid = platform.normalizeDeviceId(id);
+            const t = setInterval(() => { }, 100000);
+            platform.refreshTimers.set(nid, t);
+            platform.accessoryInstances.set(nid, { dummy: true });
+            try {
+                const mac = formatDeviceIdAsMac(id).toLowerCase();
+                platform.bleEventHandler[mac] = () => { };
+            }
+            catch {
+                // ignore formatting errors in this test
+            }
+        }
+        // Invoke didFinishLaunching to ensure the platform registered its shutdown handler
+        await Promise.resolve(api._handlers.didFinishLaunching?.());
+        // Shutdown handler should now be registered on api._handlers.shutdown
+        expect(typeof api._handlers.shutdown).toBe('function');
+        // Call the shutdown handler
+        await Promise.resolve(api._handlers.shutdown());
+        // All refresh timers should be cleared
+        for (const id of ids) {
+            const nid = platform.normalizeDeviceId(id);
+            expect(platform.refreshTimers.get(nid)).toBeUndefined();
+            expect(platform.accessoryInstances.get(nid)).toBeUndefined();
+        }
+    });
+});
+//# sourceMappingURL=platform-matter.cleanup.test.js.map

package/dist/test/platform-matter.cleanup.test.js.map

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

package/dist/test/platform-matter.keepstale.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=platform-matter.keepstale.test.d.ts.map

package/dist/test/platform-matter.keepstale.test.d.ts.map

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

package/dist/test/platform-matter.keepstale.test.js

@@ -0,0 +1,27 @@
+import { describe, expect, it, vi } from 'vitest';
+import { SwitchBotMatterPlatform } from '../platform-matter.js';
+import { makeApiStub, makeLogStub } from './helpers/platform-fixtures.js';
+describe('keepStaleAccessories config flag behavior', () => {
+    it('keeps previously-registered accessories when options.keepStaleAccessories=true', async () => {
+        const unregister = vi.fn();
+        const register = vi.fn();
+        const api = makeApiStub({ unregisterPlatformAccessories: unregister, registerPlatformAccessories: register });
+        const log = makeLogStub();
+        // Create platform with keepStaleAccessories = true
+        const platform = new SwitchBotMatterPlatform(log, { options: { keepStaleAccessories: true } }, api);
+        platform.discoveredDevices = [{ deviceId: 'DEV1', deviceType: 'Plug', deviceName: 'Device 1' }];
+        // Insert a stale accessory into matterAccessories
+        const staleUuid = api.matter.uuid.generate('stale-device');
+        const staleAcc = { uuid: staleUuid, displayName: 'Stale', context: { deviceId: 'STALE_DEVICE' } };
+        platform.matterAccessories.set(staleUuid, staleAcc);
+        // Mock createAccessoryFromDevice to return a simple accessory for DEV1
+        vi.spyOn(platform, 'createAccessoryFromDevice').mockResolvedValue({ displayName: 'Device 1', uuid: 'uuid-DEV1', context: { deviceId: 'DEV1' } });
+        // Run registration which includes stale-removal logic
+        await platform.registerMatterAccessories();
+        // Expect unregister NOT called (we kept stale accessory)
+        expect(unregister).not.toHaveBeenCalled();
+        // Stale accessory should still be present in matterAccessories
+        expect(platform.matterAccessories.get(staleUuid)).toBeDefined();
+    });
+});
+//# sourceMappingURL=platform-matter.keepstale.test.js.map

package/dist/test/platform-matter.keepstale.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-matter.keepstale.test.js","sourceRoot":"","sources":["../../src/test/platform-matter.keepstale.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAEjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAC/D,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AAEzE,QAAQ,CAAC,2CAA2C,EAAE,GAAG,EAAE;IACzD,EAAE,CAAC,gFAAgF,EAAE,KAAK,IAAI,EAAE;QAC9F,MAAM,UAAU,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QAC1B,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QACxB,MAAM,GAAG,GAAQ,WAAW,CAAC,EAAE,6BAA6B,EAAE,UAAU,EAAE,2BAA2B,EAAE,QAAQ,EAAE,CAAC,CAAA;QAElH,MAAM,GAAG,GAAQ,WAAW,EAAE,CAAA;QAE9B,mDAAmD;QACnD,MAAM,QAAQ,GAAG,IAAI,uBAAuB,CAAC,GAAU,EAAE,EAAE,OAAO,EAAE,EAAE,oBAAoB,EAAE,IAAI,EAAE,EAAS,EAAE,GAAG,CAAC,CAGhH;QAAC,QAAgB,CAAC,iBAAiB,GAAG,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAA;QAEzG,kDAAkD;QAClD,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAA;QAC1D,MAAM,QAAQ,GAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,EAAE,CACrG;QAAC,QAAgB,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;QAE7D,uEAAuE;QACvE,EAAE,CAAC,KAAK,CAAC,QAAe,EAAE,2BAA2B,CAAC,CAAC,iBAAiB,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAS,CAAC,CAAA;QAE9J,sDAAsD;QACtD,MAAO,QAAgB,CAAC,yBAAyB,EAAE,CAAA;QAEnD,yDAAyD;QACzD,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAA;QAEzC,+DAA+D;QAC/D,MAAM,CAAE,QAAgB,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;IAC1E,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/test/platform-matter.mapping.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=platform-matter.mapping.test.d.ts.map

package/dist/test/platform-matter.mapping.test.d.ts.map

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

package/dist/test/platform-matter.mapping.test.js

@@ -0,0 +1,43 @@
+import { describe, expect, it, vi } from 'vitest';
+import { SwitchBotMatterPlatform } from '../platform-matter.js';
+import { makeApiStub, makeLogStub } from './helpers/platform-fixtures.js';
+describe('platform-matter mapping helper', () => {
+    it('prefers accessory instance update methods for battery and falls back to api.matter.updateAccessoryState', async () => {
+        const updateAccessoryState = vi.fn();
+        const api = makeApiStub({ updateAccessoryState, clusterNames: { OnOff: 'OnOff', LevelControl: 'LevelControl', ColorControl: 'ColorControl', PowerSource: 'powerSource' } });
+        const log = makeLogStub();
+        const platform = new SwitchBotMatterPlatform(log, {}, api);
+        // Create a fake accessory instance with updateBatteryPercentage
+        const deviceId = 'DEV123';
+        const nid = platform.normalizeDeviceId(deviceId);
+        const fakeInstance = { updateBatteryPercentage: vi.fn() };
+        platform.accessoryInstances.set(nid, fakeInstance);
+        // Call the private helper with different battery field names
+        await platform.applyStatusToAccessory('uuid-test', { deviceId }, { batteryPercentage: 55 });
+        expect(fakeInstance.updateBatteryPercentage).toHaveBeenCalled();
+        platform.accessoryInstances.delete(nid);
+        await platform.applyStatusToAccessory('uuid-test', { deviceId }, { battery: 30 });
+        expect(updateAccessoryState).toHaveBeenCalled();
+    });
+    it('handles temperature and humidity synonyms', async () => {
+        const updateAccessoryState = vi.fn();
+        const api = makeApiStub({ updateAccessoryState });
+        const log = makeLogStub();
+        const platform = new SwitchBotMatterPlatform(log, {}, api);
+        const deviceId = 'DEV-TEMP';
+        await platform.applyStatusToAccessory('uuid-temp', { deviceId }, { temp: 21.5, humid: 48 });
+        // Expect updateAccessoryState to have been called for temperature and humidity
+        expect(updateAccessoryState).toHaveBeenCalled();
+    });
+    it('applies VOC and PM10 mappings when present', async () => {
+        const updateAccessoryState = vi.fn();
+        const api = makeApiStub({ updateAccessoryState });
+        const log = makeLogStub();
+        const platform = new SwitchBotMatterPlatform(log, {}, api);
+        const deviceId = 'DEV-AQ';
+        await platform.applyStatusToAccessory('uuid-aq', { deviceId }, { voc: 123, pm10: 56 });
+        // Expect updateAccessoryState (or safeUpdate fallback) to have been called for voc and pm10
+        expect(updateAccessoryState).toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=platform-matter.mapping.test.js.map

package/dist/test/platform-matter.mapping.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-matter.mapping.test.js","sourceRoot":"","sources":["../../src/test/platform-matter.mapping.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAEjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAC/D,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AAEzE,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,EAAE,CAAC,yGAAyG,EAAE,KAAK,IAAI,EAAE;QACvH,MAAM,oBAAoB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QACpC,MAAM,GAAG,GAAQ,WAAW,CAAC,EAAE,oBAAoB,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,EAAE,CAAC,CAAA;QAEhL,MAAM,GAAG,GAAQ,WAAW,EAAE,CAAA;QAC9B,MAAM,QAAQ,GAAG,IAAI,uBAAuB,CAAC,GAAU,EAAE,EAAS,EAAE,GAAG,CAAC,CAAA;QAExE,gEAAgE;QAChE,MAAM,QAAQ,GAAG,QAAQ,CAAA;QACzB,MAAM,GAAG,GAAI,QAAgB,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAA;QACzD,MAAM,YAAY,GAAG,EAAE,uBAAuB,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CACxD;QAAC,QAAgB,CAAC,kBAAkB,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;QAE5D,6DAA6D;QAC7D,MAAO,QAAgB,CAAC,sBAAsB,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAS,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE,CAAC,CAAA;QAC3G,MAAM,CAAC,YAAY,CAAC,uBAAuB,CAAC,CAAC,gBAAgB,EAAE,CAG9D;QAAC,QAAgB,CAAC,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACjD,MAAO,QAAgB,CAAC,sBAAsB,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAS,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAA;QACjG,MAAM,CAAC,oBAAoB,CAAC,CAAC,gBAAgB,EAAE,CAAA;IACjD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,oBAAoB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QACpC,MAAM,GAAG,GAAQ,WAAW,CAAC,EAAE,oBAAoB,EAAE,CAAC,CAAA;QAEtD,MAAM,GAAG,GAAQ,WAAW,EAAE,CAAA;QAC9B,MAAM,QAAQ,GAAG,IAAI,uBAAuB,CAAC,GAAU,EAAE,EAAS,EAAE,GAAG,CAAC,CAAA;QAExE,MAAM,QAAQ,GAAG,UAAU,CAAA;QAC3B,MAAO,QAAgB,CAAC,sBAAsB,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAS,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAA;QAE3G,+EAA+E;QAC/E,MAAM,CAAC,oBAAoB,CAAC,CAAC,gBAAgB,EAAE,CAAA;IACjD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,oBAAoB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QACpC,MAAM,GAAG,GAAQ,WAAW,CAAC,EAAE,oBAAoB,EAAE,CAAC,CAAA;QAEtD,MAAM,GAAG,GAAQ,WAAW,EAAE,CAAA;QAC9B,MAAM,QAAQ,GAAG,IAAI,uBAAuB,CAAC,GAAU,EAAE,EAAS,EAAE,GAAG,CAAC,CAAA;QAExE,MAAM,QAAQ,GAAG,QAAQ,CAAA;QACzB,MAAO,QAAgB,CAAC,sBAAsB,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAS,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAA;QAEtG,4FAA4F;QAC5F,MAAM,CAAC,oBAAoB,CAAC,CAAC,gBAAgB,EAAE,CAAA;IACjD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/test/platform-matter.openapi-mapping.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=platform-matter.openapi-mapping.test.d.ts.map

package/dist/test/platform-matter.openapi-mapping.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-matter.openapi-mapping.test.d.ts","sourceRoot":"","sources":["../../src/test/platform-matter.openapi-mapping.test.ts"],"names":[],"mappings":""}

package/dist/test/platform-matter.openapi-mapping.test.js

@@ -0,0 +1,84 @@
+import { describe, expect, it, vi } from 'vitest';
+import { SwitchBotMatterPlatform } from '../platform-matter.js';
+import { makeApiStub, makeLogStub } from './helpers/platform-fixtures.js';
+describe('platform-matter OpenAPI -> Matter mapping', () => {
+    it('maps light OpenAPI status (on/off, brightness, color, battery) to accessory instance helpers', async () => {
+        const api = makeApiStub();
+        const log = makeLogStub();
+        const platform = new SwitchBotMatterPlatform(log, {}, api);
+        const deviceId = 'LIGHT-1';
+        const nid = platform.normalizeDeviceId(deviceId);
+        const instance = {
+            updateOnOffState: vi.fn(),
+            updateBrightness: vi.fn(),
+            updateHueSaturation: vi.fn(),
+            updateBatteryPercentage: vi.fn(),
+        };
+        platform.accessoryInstances.set(nid, instance);
+        const status = { power: true, brightness: 80, color: '255:128:64', battery: 92 };
+        await platform.applyStatusToAccessory('uuid-light', { deviceId }, status);
+        expect(instance.updateOnOffState).toHaveBeenCalled();
+        expect(instance.updateBrightness).toHaveBeenCalled();
+        expect(instance.updateHueSaturation).toHaveBeenCalled();
+        expect(instance.updateBatteryPercentage).toHaveBeenCalled();
+    });
+    it('maps MeterPro OpenAPI status (temp, humid, co2, pm25, voc) to accessory instance helpers', async () => {
+        const api = makeApiStub();
+        const log = makeLogStub();
+        const platform = new SwitchBotMatterPlatform(log, {}, api);
+        const deviceId = 'METERPRO-1';
+        const nid = platform.normalizeDeviceId(deviceId);
+        const instance = {
+            updateTemperature: vi.fn(),
+            updateHumidity: vi.fn(),
+            updateCO2: vi.fn(),
+            updatePM25: vi.fn(),
+            updateVOC: vi.fn(),
+        };
+        platform.accessoryInstances.set(nid, instance);
+        const status = { temp: 21.4, humid: 45, co2: 410, pm25: 12, voc: 85 };
+        await platform.applyStatusToAccessory('uuid-meter', { deviceId }, status);
+        expect(instance.updateTemperature).toHaveBeenCalled();
+        expect(instance.updateHumidity).toHaveBeenCalled();
+        expect(instance.updateCO2).toHaveBeenCalled();
+        expect(instance.updatePM25).toHaveBeenCalled();
+        expect(instance.updateVOC).toHaveBeenCalled();
+    });
+    it('maps lock OpenAPI status to lock helper', async () => {
+        const api = makeApiStub();
+        const log = makeLogStub();
+        const platform = new SwitchBotMatterPlatform(log, {}, api);
+        const deviceId = 'LOCK-1';
+        const nid = platform.normalizeDeviceId(deviceId);
+        const instance = { updateLockState: vi.fn() };
+        platform.accessoryInstances.set(nid, instance);
+        const status = { lock: true };
+        await platform.applyStatusToAccessory('uuid-lock', { deviceId }, status);
+        expect(instance.updateLockState).toHaveBeenCalled();
+    });
+    it('maps curtain position synonyms to lift position helper', async () => {
+        const api = makeApiStub();
+        const log = makeLogStub();
+        const platform = new SwitchBotMatterPlatform(log, {}, api);
+        const deviceId = 'CURTAIN-1';
+        const nid = platform.normalizeDeviceId(deviceId);
+        const instance = { updateLiftPosition: vi.fn() };
+        platform.accessoryInstances.set(nid, instance);
+        await platform.applyStatusToAccessory('uuid-cur', { deviceId, deviceType: 'Curtain' }, { position: 25 });
+        await platform.applyStatusToAccessory('uuid-cur', { deviceId, deviceType: 'Curtain' }, { slidePosition: 75 });
+        expect(instance.updateLiftPosition).toHaveBeenCalled();
+    });
+    it('maps robot vacuum run state / on to updateRunMode or updateOperationalState', async () => {
+        const api = makeApiStub();
+        const log = makeLogStub();
+        const platform = new SwitchBotMatterPlatform(log, {}, api);
+        const deviceId = 'RVC-1';
+        const nid = platform.normalizeDeviceId(deviceId);
+        const instance = { updateRunMode: vi.fn(), updateOperationalState: vi.fn() };
+        platform.accessoryInstances.set(nid, instance);
+        await platform.applyStatusToAccessory('uuid-rvc', { deviceId, deviceType: 'K10+' }, { runState: 'cleaning', power: true });
+        const calls = (instance.updateRunMode.mock?.calls?.length || 0) + (instance.updateOperationalState.mock?.calls?.length || 0);
+        expect(calls).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=platform-matter.openapi-mapping.test.js.map

package/dist/test/platform-matter.openapi-mapping.test.js.map

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

package/dist/test/platform-matter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=platform-matter.test.d.ts.map

package/dist/test/platform-matter.test.d.ts.map

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

package/dist/test/platform-matter.test.js

@@ -0,0 +1,117 @@
+import { describe, expect, it, vi } from 'vitest';
+import { SwitchBotMatterPlatform } from '../platform-matter.js';
+import { PLATFORM_NAME, PLUGIN_NAME } from '../settings.js';
+import { makeApiStub, makeLogStub } from './helpers/platform-fixtures.js';
+describe('platform-matter discovered devices', () => {
+    it('uses discovered devices and registers them (platform + robotic)', async () => {
+        const mockRegister = vi.fn();
+        const api = makeApiStub({
+            registerPlatformAccessories: mockRegister,
+            clusterNames: { OnOff: 'OnOff', LevelControl: 'LevelControl', ColorControl: 'ColorControl' },
+            deviceTypes: { RoboticVacuumCleaner: 'rvc' },
+        });
+        const log = makeLogStub();
+        const config = {};
+        const platform = new SwitchBotMatterPlatform(log, config, api);
+        platform.discoveredDevices = [
+            { deviceId: 'dev1', deviceName: 'Lamp', deviceType: 'Plug' },
+            { deviceId: 'vac1', deviceName: 'Vac', deviceType: 'K10+' },
+        ];
+        platform.createAccessoryFromDevice = async (dev) => ({ displayName: dev.deviceName, uuid: api.matter.uuid.generate(dev.deviceId) });
+        await platform.registerMatterAccessories();
+        // Ensure registerPlatformAccessories was called at least once
+        expect(mockRegister).toHaveBeenCalled();
+        // Sum total accessories registered across all calls
+        const totalRegistered = mockRegister.mock.calls.reduce((sum, call) => sum + ((call[2] && call[2].length) || 0), 0);
+        expect(totalRegistered).toBe(2);
+        // Verify PLUGIN_NAME and PLATFORM_NAME were used in the calls
+        for (const call of mockRegister.mock.calls) {
+            expect(call[0]).toBe(PLUGIN_NAME);
+            expect(call[1]).toBe(PLATFORM_NAME);
+        }
+    });
+    it('applies per-device config overrides when deviceId matches discovered device', async () => {
+        const mockRegister = vi.fn();
+        const api = {
+            matter: {
+                uuid: { generate: (s) => `uuid-${s}` },
+                registerPlatformAccessories: mockRegister,
+                clusterNames: { OnOff: 'OnOff', LevelControl: 'LevelControl', ColorControl: 'ColorControl' },
+                deviceTypes: { RoboticVacuumCleaner: 'rvc' },
+            },
+            isMatterAvailable: () => true,
+            isMatterEnabled: () => true,
+            on: () => { },
+        };
+        const log = { info: vi.fn(), warn: vi.fn(), debug: vi.fn(), error: vi.fn() };
+        const config = {
+            options: {
+                devices: [{ deviceId: 'dev1', configDeviceName: 'Configured Lamp', logging: 'debug' }],
+            },
+        };
+        const platform = new SwitchBotMatterPlatform(log, config, api);
+        platform.discoveredDevices = [{ deviceId: 'dev1', deviceName: 'Lamp', deviceType: 'Plug' }];
+        const seen = [];
+        platform.createAccessoryFromDevice = async (dev) => {
+            seen.push(dev);
+            return {
+                displayName: dev.deviceName ?? dev.configDeviceName,
+                uuid: api.matter.uuid.generate(dev.deviceId),
+            };
+        };
+        await platform.registerMatterAccessories();
+        // createAccessoryFromDevice should have been called once with merged config
+        expect(seen.length).toBe(1);
+        expect(seen[0].deviceId).toBe('dev1');
+        // per-device config values should be present on the merged device
+        expect(seen[0].configDeviceName).toBe('Configured Lamp');
+        expect(seen[0].logging).toBe('debug');
+    });
+    it('ignores config-only devices by default but includes them when allowConfigOnlyDevices=true', async () => {
+        const mockRegister = vi.fn();
+        const api = {
+            matter: {
+                uuid: { generate: (s) => `uuid-${s}` },
+                registerPlatformAccessories: mockRegister,
+                clusterNames: { OnOff: 'OnOff', LevelControl: 'LevelControl', ColorControl: 'ColorControl' },
+                deviceTypes: { RoboticVacuumCleaner: 'rvc' },
+            },
+            isMatterAvailable: () => true,
+            isMatterEnabled: () => true,
+            on: () => { },
+        };
+        const log = { info: vi.fn(), warn: vi.fn(), debug: vi.fn(), error: vi.fn() };
+        // config-only device (cfg1) and one discovered device (dev1)
+        const cfgOnly = { deviceId: 'cfg1', configDeviceName: 'OnlyInConfig', deviceType: 'Plug' };
+        const configDefault = { options: { devices: [cfgOnly] } };
+        const platformDefault = new SwitchBotMatterPlatform(log, configDefault, api);
+        platformDefault.discoveredDevices = [{ deviceId: 'dev1', deviceName: 'Lamp', deviceType: 'Plug' }];
+        const seenDefault = [];
+        platformDefault.createAccessoryFromDevice = async (dev) => {
+            seenDefault.push(dev);
+            return {
+                displayName: dev.deviceName ?? dev.configDeviceName,
+                uuid: api.matter.uuid.generate(dev.deviceId),
+            };
+        };
+        await platformDefault.registerMatterAccessories();
+        // Should only see discovered device (cfg1 ignored)
+        expect(seenDefault.find((d) => d.deviceId === 'cfg1')).toBeUndefined();
+        // Now opt-in to include config-only devices
+        const configOptIn = { options: { devices: [cfgOnly], allowConfigOnlyDevices: true } };
+        const platformOptIn = new SwitchBotMatterPlatform(log, configOptIn, api);
+        platformOptIn.discoveredDevices = [{ deviceId: 'dev1', deviceName: 'Lamp', deviceType: 'Plug' }];
+        const seenOptIn = [];
+        platformOptIn.createAccessoryFromDevice = async (dev) => {
+            seenOptIn.push(dev);
+            return {
+                displayName: dev.deviceName ?? dev.configDeviceName,
+                uuid: api.matter.uuid.generate(dev.deviceId),
+            };
+        };
+        await platformOptIn.registerMatterAccessories();
+        // Should include the config-only device now
+        expect(seenOptIn.find((d) => d.deviceId === 'cfg1')).toBeDefined();
+    });
+});
+//# sourceMappingURL=platform-matter.test.js.map

package/dist/test/platform-matter.test.js.map

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

package/dist/test/platform-matter.unregister.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=platform-matter.unregister.test.d.ts.map

package/dist/test/platform-matter.unregister.test.d.ts.map

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

package/dist/test/platform-matter.unregister.test.js

@@ -0,0 +1,30 @@
+import { describe, expect, it, vi } from 'vitest';
+import { SwitchBotMatterPlatform } from '../platform-matter.js';
+import { makeApiStub, makeLogStub } from './helpers/platform-fixtures.js';
+describe('removeDisabledAccessories and unregister edge cases', () => {
+    it('clears resources and unregisters accessory even with invalid timer and non-MAC deviceId', async () => {
+        // Prepare API stub
+        const unregister = vi.fn();
+        const api = makeApiStub({ unregisterPlatformAccessories: unregister });
+        const log = makeLogStub();
+        const platform = new SwitchBotMatterPlatform(log, { enableOnOffLight: false }, api);
+        // Build a fake serialized accessory matching the generated UUID for OnOff Light
+        const uuid = api.matter.uuid.generate('matter-onoff-light');
+        const accessory = { uuid, displayName: 'OnOff Light', context: { deviceId: 'NOT-A-MAC' } };
+        // Put invalid timer object into refreshTimers to ensure code handles it
+        const nid = platform.normalizeDeviceId(accessory.context.deviceId);
+        platform.refreshTimers.set(nid, null);
+        platform.accessoryInstances.set(nid, { dummy: true });
+        platform.matterAccessories.set(uuid, accessory);
+        // Spy on clearDeviceResources
+        const spyClear = vi.spyOn(platform, 'clearDeviceResources');
+        // Call removeDisabledAccessories directly
+        await platform.removeDisabledAccessories();
+        // Expect unregister was called and matterAccessories cleared
+        expect(unregister).toHaveBeenCalled();
+        expect(platform.matterAccessories.get(uuid)).toBeUndefined();
+        // clearDeviceResources should have been called with the accessory.deviceId
+        expect(spyClear).toHaveBeenCalledWith(accessory.context.deviceId);
+    });
+});
+//# sourceMappingURL=platform-matter.unregister.test.js.map

package/dist/test/platform-matter.unregister.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-matter.unregister.test.js","sourceRoot":"","sources":["../../src/test/platform-matter.unregister.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAEjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAC/D,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AAEzE,QAAQ,CAAC,qDAAqD,EAAE,GAAG,EAAE;IACnE,EAAE,CAAC,yFAAyF,EAAE,KAAK,IAAI,EAAE;QACvG,mBAAmB;QACnB,MAAM,UAAU,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QAC1B,MAAM,GAAG,GAAQ,WAAW,CAAC,EAAE,6BAA6B,EAAE,UAAU,EAAE,CAAC,CAAA;QAC3E,MAAM,GAAG,GAAQ,WAAW,EAAE,CAAA;QAC9B,MAAM,QAAQ,GAAG,IAAI,uBAAuB,CAAC,GAAU,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAS,EAAE,GAAG,CAAC,CAAA;QAEjG,gFAAgF;QAChF,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAA;QAC3D,MAAM,SAAS,GAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,CAAA;QAE/F,wEAAwE;QACxE,MAAM,GAAG,GAAI,QAAgB,CAAC,iBAAiB,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAC1E;QAAC,QAAgB,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,IAAW,CAAC,CACrD;QAAC,QAAgB,CAAC,kBAAkB,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAG9D;QAAC,QAAgB,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;QAEzD,8BAA8B;QAC9B,MAAM,QAAQ,GAAG,EAAE,CAAC,KAAK,CAAC,QAAe,EAAE,sBAAsB,CAAC,CAAA;QAElE,0CAA0C;QAC1C,MAAO,QAAgB,CAAC,yBAAyB,EAAE,CAAA;QAEnD,6DAA6D;QAC7D,MAAM,CAAC,UAAU,CAAC,CAAC,gBAAgB,EAAE,CAAA;QACrC,MAAM,CAAE,QAAgB,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,EAAE,CAAA;QAErE,2EAA2E;QAC3E,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IACnE,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/utils.d.ts

@@ -1,3 +1,4 @@
+import type { API, Logging } from 'homebridge';
 import type { blindTilt, curtain, curtain3, device } from 'node-switchbot';
 import type { devicesConfig } from './settings.js';
 export declare enum BlindTiltMappingMode {
@@ -48,4 +49,130 @@ export declare function m2hs(m: any): number[];
  * Returns undefined if nothing meaningful remains.
  */
 export declare function cleanDeviceConfig(deviceConfig?: Record<string, Record<string, any>>): Record<string, Record<string, any>> | undefined;
+/**
+ * Factory that returns a function to send OpenAPI commands using a retry wrapper.
+ *
+ * @param retryCommandFunc - bound function that calls platform.retryCommand(device, bodyChange, maxRetries, delay)
+ * @param deviceObj - the device object to operate on
+ * @param opts - optional overrides for maxRetries and delayBetweenRetries
+ * @param opts.maxRetries - override for maxRetries
+ * @param opts.delayBetweenRetries - override for delayBetweenRetries
+ */
+export declare function makeOpenAPISender(retryCommandFunc: any, deviceObj: any, opts?: {
+    maxRetries?: number;
+    delayBetweenRetries?: number;
+}): (command: string, parameter?: string) => Promise<any>;
+/**
+ * Factory that returns a function to perform BLE actions using a SwitchBotBLE client.
+ * Handles discovery retries and method invocation on the discovered device instance.
+ *
+ * @param switchBotBLE - instance of SwitchBotBLE (may be undefined)
+ * @param deviceObj - the device object (used to obtain bleModel/deviceId)
+ * @param opts - optional retry settings
+ * @param opts.bleRetries - number of BLE discovery retries
+ * @param opts.bleRetryDelay - delay between BLE retries in ms
+ */
+export declare function makeBLESender(switchBotBLE: any, deviceObj: any, opts?: {
+    bleRetries?: number;
+    bleRetryDelay?: number;
+}): (methodName: string, ...args: any[]) => Promise<any>;
+/**
+ * Decide effective connection type for a device given platform options.
+ * Mirrors the logic previously in platform-matter.
+ */
+export declare function chooseConnectionType(platformOptions: any, deviceObj: any): 'BLE' | 'OpenAPI';
+/**
+ * Detect whether Matter is enabled/available on the provided Homebridge API object.
+ * This encapsulates the multi-fallback detection used across the project.
+ */
+/**
+ * Detect whether Matter is enabled on the provided Homebridge API object.
+ * Returns an object with an `enabled` boolean and an optional `reason` string
+ * describing which check matched (useful for diagnostics).
+ */
+export declare function detectMatter(apiObj: API): {
+    enabled: boolean;
+    reason?: string;
+};
+/**
+ * Backwards-compatible boolean wrapper for detectMatter.
+ */
+export declare function detectMatterEnabled(apiObj: API): boolean;
+/**
+ * Create platform logging helpers used by both HAP and Matter platforms.
+ *
+ * getPlatformLogging may be either a synchronous string-returning function or an
+ * async function that resolves to the current platform logging setting. The
+ * returned helpers mirror the instance methods previously implemented on the
+ * HAP platform (infoLog, warnLog, errorLog, debugLog, etc.).
+ */
+export declare function createPlatformLogger(getPlatformLogging: () => string | Promise<string | undefined>, log: Logging): {
+    infoLog: (...args: any[]) => Promise<void>;
+    successLog: (...args: any[]) => Promise<void>;
+    debugSuccessLog: (...args: any[]) => Promise<void>;
+    warnLog: (...args: any[]) => Promise<void>;
+    debugWarnLog: (...args: any[]) => Promise<void>;
+    errorLog: (...args: any[]) => Promise<void>;
+    debugErrorLog: (...args: any[]) => Promise<void>;
+    debugLog: (...args: any[]) => Promise<void>;
+    loggingIsDebug: () => Promise<boolean>;
+    enablingPlatformLogging: () => Promise<boolean>;
+};
+/**
+ * Create a Platform proxy class that selects between two platform constructors
+ * (HAP vs Matter) at runtime using `detectMatter`. Returns a class suitable
+ * for passing to `api.registerPlatform`.
+ */
+export declare function createPlatformProxy(HAPCtor: any, MatterCtor: any): {
+    new (log: any, config: any, api: API): {
+        delegate: any;
+        readonly log: any;
+        readonly config: any;
+        readonly api: API;
+        configureAccessory(accessory: any): void;
+        configureMatterAccessory?(accessory: any): void;
+        get accessories(): any;
+        get matterAccessories(): any;
+    };
+};
+/**
+ * API Request Tracker - Persistent tracking of SwitchBot API calls
+ * Tracks requests per day with automatic midnight rollover
+ */
+export declare class ApiRequestTracker {
+    private count;
+    private date;
+    private statsFile;
+    private hourlyTimer?;
+    private log;
+    constructor(api: API, log: Logging, pluginName?: string);
+    /**
+     * Load API request statistics from persistent storage
+     */
+    private load;
+    /**
+     * Save API request statistics to persistent storage
+     */
+    private save;
+    /**
+     * Increment API request counter and save
+     */
+    track(): void;
+    /**
+     * Start hourly logging of API request count
+     */
+    startHourlyLogging(): void;
+    /**
+     * Stop hourly logging
+     */
+    stopHourlyLogging(): void;
+    /**
+     * Get current count
+     */
+    getCount(): number;
+    /**
+     * Get current date
+     */
+    getDate(): string;
+}
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAE1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAElD,oBAAY,oBAAoB;IAC9B,MAAM,YAAY;IAClB,QAAQ,cAAc;IACtB,SAAS,gBAAgB;IACzB,SAAS,gBAAgB;IACzB,mBAAmB,2BAA2B;CAC/C;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,GAAG,aAAa,CAE9G;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,IAAI,SAAS,GAAG,aAAa,CAErG;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AACD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAOlF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAQlF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,UAWrC;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,CA6BrF;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,YAiC5C;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,YAyCpC;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,OA8D9B;AAED,wBAAgB,IAAI,CAAC,CAAC,KAAA,YA2ZrB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,SAAS,CA2CrI"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}