@homebridge-plugins/homebridge-updater 3.0.7

package/dist/updateSensor.test.js

@@ -0,0 +1,133 @@
+import { describe, expect, it, vi } from 'vitest';
+/**
+ * Regression test for: update checks not running after Homebridge restart
+ *
+ * When Homebridge restarts, cached accessories are restored via `configureAccessory`
+ * before `didFinishLaunching` fires. The previous implementation returned early in
+ * `addUpdateSensor` when `registered` was already true, which prevented the initial
+ * check and scheduled cron jobs from being started.
+ */
+describe('updateSensor cached accessory restore', () => {
+    it('should start update checks even when the accessory is restored from cache', async () => {
+        // Arrange: track calls to startScheduledChecks and doCheck (via checkUi)
+        const checkUiCalls = [];
+        const startScheduledChecksCalls = [];
+        // Minimal mock for UpdateCheckCore
+        const mockUpdateCore = {
+            initialCheckDelay: 0,
+            checkUi: vi.fn().mockResolvedValue(0),
+            startScheduledChecks: vi.fn((_cb) => {
+                startScheduledChecksCalls.push(1);
+            }),
+            getLastAutoUpdateFailed: vi.fn().mockReturnValue(false),
+        };
+        // Minimal mock for a HAP sensor
+        const mockSensor = {
+            configure: vi.fn(),
+            setState: vi.fn(),
+        };
+        // Minimal mock for the Homebridge API (HAP path, no Matter)
+        const mockAccessory = {
+            UUID: 'test-uuid',
+            displayName: 'Plugin Update Check',
+            on: vi.fn(),
+        };
+        const mockApi = {
+            matter: undefined,
+            hap: {
+                uuid: {
+                    generate: vi.fn().mockReturnValue('test-uuid'),
+                },
+            },
+            platformAccessory: vi.fn().mockReturnValue(mockAccessory),
+            registerPlatformAccessories: vi.fn(),
+            user: { storagePath: vi.fn().mockReturnValue('/tmp') },
+            on: vi.fn(),
+        };
+        // Build the UpdateSensor object directly by manipulating internal state
+        // to simulate the cached accessory scenario without needing to import the full class
+        // (which requires a real Homebridge environment).
+        //
+        // Instead, we test the *logic* extracted from addUpdateSensor:
+        // The fix ensures that checks are started whether or not the accessory was cached.
+        let registered = false;
+        // Simulate configureAccessory being called (cached accessory restore)
+        function configureAccessory(_accessory) {
+            mockSensor.configure(_accessory);
+            registered = true;
+        }
+        // Fixed addUpdateSensor: only skips accessory creation, always starts checks
+        function addUpdateSensor() {
+            if (!registered) {
+                // Would create and register the accessory here
+                mockSensor.configure(mockAccessory);
+                registered = true;
+            }
+            // Always start checks
+            setTimeout(() => {
+                mockUpdateCore.checkUi().then((updates) => {
+                    checkUiCalls.push(updates);
+                    mockSensor.setState(!!updates);
+                });
+            }, mockUpdateCore.initialCheckDelay * 1000);
+            mockUpdateCore.startScheduledChecks(() => {
+                mockUpdateCore.checkUi();
+            });
+        }
+        // Simulate Homebridge restart: cached accessory is restored first
+        configureAccessory(mockAccessory);
+        expect(registered).toBe(true);
+        // Then addUpdateSensor fires on didFinishLaunching
+        addUpdateSensor();
+        // The accessory should NOT be reconfigured (already was via restore)
+        expect(mockSensor.configure).toHaveBeenCalledTimes(1);
+        // Scheduled checks MUST be started
+        expect(startScheduledChecksCalls).toHaveLength(1);
+        expect(mockUpdateCore.startScheduledChecks).toHaveBeenCalledTimes(1);
+        // Wait for setTimeout(0) to fire
+        await new Promise(resolve => setTimeout(resolve, 10));
+        // The initial check must have run
+        expect(mockUpdateCore.checkUi).toHaveBeenCalled();
+        expect(checkUiCalls).toHaveLength(1);
+    });
+    it('should NOT start checks twice when addUpdateSensor is called on first launch (no cached accessory)', async () => {
+        const startScheduledChecksCalls = [];
+        const configureCalls = [];
+        const mockUpdateCore = {
+            initialCheckDelay: 0,
+            checkUi: vi.fn().mockResolvedValue(1),
+            startScheduledChecks: vi.fn((_cb) => {
+                startScheduledChecksCalls.push(1);
+            }),
+            getLastAutoUpdateFailed: vi.fn().mockReturnValue(false),
+        };
+        const mockSensor = {
+            configure: vi.fn((_acc) => configureCalls.push(1)),
+            setState: vi.fn(),
+        };
+        const mockAccessory = {
+            UUID: 'test-uuid',
+            displayName: 'Plugin Update Check',
+        };
+        let registered = false;
+        // Fixed addUpdateSensor (no prior configureAccessory call)
+        function addUpdateSensor() {
+            if (!registered) {
+                mockSensor.configure(mockAccessory);
+                registered = true;
+            }
+            setTimeout(() => {
+                mockUpdateCore.checkUi();
+            }, mockUpdateCore.initialCheckDelay * 1000);
+            mockUpdateCore.startScheduledChecks(() => {
+                mockUpdateCore.checkUi();
+            });
+        }
+        // First launch: no cached accessory; addUpdateSensor creates it
+        addUpdateSensor();
+        expect(registered).toBe(true);
+        expect(configureCalls).toHaveLength(1);
+        expect(startScheduledChecksCalls).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=updateSensor.test.js.map

package/dist/updateSensor.test.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,22 @@
+import type { PlatformConfig } from 'homebridge';
+/**
+ * Returns true if the failure sensor should be registered and active.
+ *
+ * The failure sensor is disabled when:
+ * - `failureSensorType` is explicitly set to `"none"`, OR
+ * - none of the auto-update options (autoUpdateNode, autoUpdateHomebridge,
+ *   autoUpdateHomebridgeUI, autoUpdatePlugins, autoUpdateNpm) are enabled, because without
+ *   auto-updates there can never be an auto-update failure to report.
+ */
+export declare function isFailureSensorEnabled(config: PlatformConfig): boolean;
+/**
+ * Factory function that creates a platform proxy constructor.
+ * Selects between HAP and Matter platform implementations at runtime
+ * based on whether Homebridge Matter support is available and enabled.
+ *
+ * @param HAPPlatform The HAP platform class constructor.
+ * @param MatterPlatform The Matter platform class constructor.
+ * @returns A proxy class that delegates to the correct platform implementation.
+ */
+export declare function createPlatformProxy(HAPPlatform: any, MatterPlatform: any): any;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAIhD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAMtE;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,GAAG,GAAG,CAoD9E"}

package/dist/utils.js

@@ -0,0 +1,75 @@
+/**
+ * Returns true if the failure sensor should be registered and active.
+ *
+ * The failure sensor is disabled when:
+ * - `failureSensorType` is explicitly set to `"none"`, OR
+ * - none of the auto-update options (autoUpdateNode, autoUpdateHomebridge,
+ *   autoUpdateHomebridgeUI, autoUpdatePlugins, autoUpdateNpm) are enabled, because without
+ *   auto-updates there can never be an auto-update failure to report.
+ */
+export function isFailureSensorEnabled(config) {
+    const cfg = config;
+    if (cfg.failureSensorType === 'none') {
+        return false;
+    }
+    return !!(cfg.autoUpdateNode || cfg.autoUpdateHomebridge || cfg.autoUpdateHomebridgeUI || cfg.autoUpdatePlugins || cfg.autoUpdateNpm);
+}
+/**
+ * Factory function that creates a platform proxy constructor.
+ * Selects between HAP and Matter platform implementations at runtime
+ * based on whether Homebridge Matter support is available and enabled.
+ *
+ * @param HAPPlatform The HAP platform class constructor.
+ * @param MatterPlatform The Matter platform class constructor.
+ * @returns A proxy class that delegates to the correct platform implementation.
+ */
+export function createPlatformProxy(HAPPlatform, MatterPlatform) {
+    return class PluginUpdatePlatformProxy {
+        /** The instantiated platform implementation (HAP or Matter) */
+        impl;
+        /**
+         * Constructs the proxy and instantiates the correct platform implementation.
+         * @param log Logger instance
+         * @param config Platform config
+         * @param api Homebridge API instance
+         * @returns The instantiated platform implementation
+         */
+        constructor(log, config, api) {
+            const enableMatter = config.enableMatter ?? true;
+            const hasMatterApi = !!api?.matter;
+            const matterAvailable = typeof api?.isMatterAvailable === 'function' ? !!api.isMatterAvailable() : hasMatterApi;
+            const matterEnabled = typeof api?.isMatterEnabled === 'function' ? !!api.isMatterEnabled() : hasMatterApi;
+            if (enableMatter && MatterPlatform && hasMatterApi && matterAvailable && matterEnabled) {
+                log?.debug?.('[Protocol] Using Matter platform implementation');
+                this.impl = new MatterPlatform(log, config, api);
+                return;
+            }
+            if (enableMatter) {
+                const reasons = [];
+                if (!MatterPlatform) {
+                    reasons.push('Matter platform class unavailable');
+                }
+                if (!hasMatterApi) {
+                    reasons.push('api.matter missing');
+                }
+                if (!matterAvailable) {
+                    reasons.push('Matter not available');
+                }
+                if (!matterEnabled) {
+                    reasons.push('Matter not enabled');
+                }
+                const reasonText = reasons.length ? reasons.join(', ') : 'unknown reason';
+                log?.debug?.(`[Protocol] Falling back to HAP: ${reasonText}`);
+            }
+            else {
+                log?.debug?.('[Protocol] Using HAP platform implementation');
+            }
+            // Fallback to HAP
+            this.impl = new HAPPlatform(log, config, api);
+        }
+        configureAccessory(...args) {
+            return this.impl?.configureAccessory?.(...args);
+        }
+    };
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAsB;IAC3D,MAAM,GAAG,GAAG,MAAoC,CAAA;IAChD,IAAI,GAAG,CAAC,iBAAiB,KAAK,MAAM,EAAE,CAAC;QACrC,OAAO,KAAK,CAAA;IACd,CAAC;IACD,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,IAAI,GAAG,CAAC,oBAAoB,IAAI,GAAG,CAAC,sBAAsB,IAAI,GAAG,CAAC,iBAAiB,IAAI,GAAG,CAAC,aAAa,CAAC,CAAA;AACvI,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAgB,EAAE,cAAmB;IACvE,OAAO,MAAM,yBAAyB;QACpC,+DAA+D;QACvD,IAAI,CAAK;QAEjB;;;;;;WAMG;QACH,YAAY,GAAQ,EAAE,MAAsB,EAAE,GAAQ;YACpD,MAAM,YAAY,GAAI,MAAc,CAAC,YAAY,IAAI,IAAI,CAAA;YACzD,MAAM,YAAY,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,CAAA;YAClC,MAAM,eAAe,GAAG,OAAO,GAAG,EAAE,iBAAiB,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,YAAY,CAAA;YAC/G,MAAM,aAAa,GAAG,OAAO,GAAG,EAAE,eAAe,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,YAAY,CAAA;YAEzG,IAAI,YAAY,IAAI,cAAc,IAAI,YAAY,IAAI,eAAe,IAAI,aAAa,EAAE,CAAC;gBACvF,GAAG,EAAE,KAAK,EAAE,CAAC,iDAAiD,CAAC,CAAA;gBAC/D,IAAI,CAAC,IAAI,GAAG,IAAI,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,CAAA;gBAChD,OAAM;YACR,CAAC;YAED,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,OAAO,GAAa,EAAE,CAAA;gBAC5B,IAAI,CAAC,cAAc,EAAE,CAAC;oBACpB,OAAO,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAA;gBACnD,CAAC;gBACD,IAAI,CAAC,YAAY,EAAE,CAAC;oBAClB,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;gBACpC,CAAC;gBACD,IAAI,CAAC,eAAe,EAAE,CAAC;oBACrB,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;gBACtC,CAAC;gBACD,IAAI,CAAC,aAAa,EAAE,CAAC;oBACnB,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;gBACpC,CAAC;gBACD,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAA;gBACzE,GAAG,EAAE,KAAK,EAAE,CAAC,mCAAmC,UAAU,EAAE,CAAC,CAAA;YAC/D,CAAC;iBAAM,CAAC;gBACN,GAAG,EAAE,KAAK,EAAE,CAAC,8CAA8C,CAAC,CAAA;YAC9D,CAAC;YAED,kBAAkB;YAClB,IAAI,CAAC,IAAI,GAAG,IAAI,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,CAAA;QAC/C,CAAC;QAED,kBAAkB,CAAC,GAAG,IAAW;YAC/B,OAAO,IAAI,CAAC,IAAI,EAAE,kBAAkB,EAAE,CAAC,GAAG,IAAI,CAAC,CAAA;QACjD,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/utils.test.d.ts

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

package/dist/utils.test.d.ts.map

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

package/dist/utils.test.js

@@ -0,0 +1,126 @@
+import { describe, expect, it } from 'vitest';
+import { createPlatformProxy, isFailureSensorEnabled } from './utils.js';
+describe('isFailureSensorEnabled', () => {
+    it('should return false when failureSensorType is "none"', () => {
+        expect(isFailureSensorEnabled({ failureSensorType: 'none', autoUpdateHomebridge: true })).toBe(false);
+    });
+    it('should return false when no auto-update option is enabled', () => {
+        expect(isFailureSensorEnabled({})).toBe(false);
+        expect(isFailureSensorEnabled({ autoUpdateHomebridge: false, autoUpdateHomebridgeUI: false, autoUpdatePlugins: false, autoUpdateNode: false, autoUpdateNpm: false })).toBe(false);
+    });
+    it('should return true when at least one auto-update option is enabled', () => {
+        expect(isFailureSensorEnabled({ autoUpdateHomebridge: true })).toBe(true);
+        expect(isFailureSensorEnabled({ autoUpdateHomebridgeUI: true })).toBe(true);
+        expect(isFailureSensorEnabled({ autoUpdatePlugins: true })).toBe(true);
+        expect(isFailureSensorEnabled({ autoUpdateNode: true })).toBe(true);
+        expect(isFailureSensorEnabled({ autoUpdateNpm: true })).toBe(true);
+    });
+    it('should return false when failureSensorType is "none" even if auto-updates are enabled', () => {
+        const config = {
+            failureSensorType: 'none',
+            autoUpdateHomebridge: true,
+            autoUpdateHomebridgeUI: true,
+            autoUpdatePlugins: true,
+            autoUpdateNode: true,
+            autoUpdateNpm: true,
+        };
+        expect(isFailureSensorEnabled(config)).toBe(false);
+    });
+    it('should return true when failureSensorType is a valid sensor and auto-update is enabled', () => {
+        expect(isFailureSensorEnabled({ failureSensorType: 'motion', autoUpdateHomebridge: true })).toBe(true);
+        expect(isFailureSensorEnabled({ failureSensorType: 'contact', autoUpdatePlugins: true })).toBe(true);
+    });
+});
+describe('createPlatformProxy', () => {
+    it('should fall back to HAP platform when Matter is not available', () => {
+        const hapConstructed = [];
+        const matterConstructed = [];
+        class MockHAPPlatform {
+            constructor(log, config, api) {
+                hapConstructed.push({ log, config, api });
+            }
+        }
+        class MockMatterPlatform {
+            constructor(log, config, api) {
+                matterConstructed.push({ log, config, api });
+            }
+        }
+        const ProxyCtor = createPlatformProxy(MockHAPPlatform, MockMatterPlatform);
+        // api without Matter support
+        const api = {};
+        new ProxyCtor('log', { enableMatter: true }, api);
+        expect(hapConstructed).toHaveLength(1);
+        expect(matterConstructed).toHaveLength(0);
+    });
+    it('should use Matter platform when Matter is available and enabled', () => {
+        const hapConstructed = [];
+        const matterConstructed = [];
+        class MockHAPPlatform {
+            constructor(log, config, api) {
+                hapConstructed.push({ log, config, api });
+            }
+        }
+        class MockMatterPlatform {
+            constructor(log, config, api) {
+                matterConstructed.push({ log, config, api });
+            }
+        }
+        const ProxyCtor = createPlatformProxy(MockHAPPlatform, MockMatterPlatform);
+        // api with Matter support available and enabled
+        const api = {
+            matter: {},
+            isMatterAvailable: () => true,
+            isMatterEnabled: () => true,
+        };
+        new ProxyCtor('log', { enableMatter: true }, api);
+        expect(matterConstructed).toHaveLength(1);
+        expect(hapConstructed).toHaveLength(0);
+    });
+    it('should fall back to HAP when enableMatter is false', () => {
+        const hapConstructed = [];
+        const matterConstructed = [];
+        class MockHAPPlatform {
+            constructor(log, config, api) {
+                hapConstructed.push({ log, config, api });
+            }
+        }
+        class MockMatterPlatform {
+            constructor(log, config, api) {
+                matterConstructed.push({ log, config, api });
+            }
+        }
+        const ProxyCtor = createPlatformProxy(MockHAPPlatform, MockMatterPlatform);
+        // Matter available but disabled in config
+        const api = {
+            matter: {},
+            isMatterAvailable: () => true,
+            isMatterEnabled: () => true,
+        };
+        new ProxyCtor('log', { enableMatter: false }, api);
+        expect(hapConstructed).toHaveLength(1);
+        expect(matterConstructed).toHaveLength(0);
+    });
+    it('should use Matter when isMatter* APIs are unavailable but matter API exists', () => {
+        const hapConstructed = [];
+        const matterConstructed = [];
+        class MockHAPPlatform {
+            constructor(log, config, api) {
+                hapConstructed.push({ log, config, api });
+            }
+        }
+        class MockMatterPlatform {
+            constructor(log, config, api) {
+                matterConstructed.push({ log, config, api });
+            }
+        }
+        const ProxyCtor = createPlatformProxy(MockHAPPlatform, MockMatterPlatform);
+        // API shape used in some Homebridge versions/plugins where isMatter* may not exist.
+        const api = {
+            matter: {},
+        };
+        new ProxyCtor('log', { enableMatter: true }, api);
+        expect(matterConstructed).toHaveLength(1);
+        expect(hapConstructed).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=utils.test.js.map

package/dist/utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.test.js","sourceRoot":"","sources":["../src/utils.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAExE,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,CAAC,sBAAsB,CAAC,EAAE,iBAAiB,EAAE,MAAM,EAAE,oBAAoB,EAAE,IAAI,EAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC9G,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,CAAC,sBAAsB,CAAC,EAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACrD,MAAM,CAAC,sBAAsB,CAAC,EAAE,oBAAoB,EAAE,KAAK,EAAE,sBAAsB,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC1L,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,MAAM,CAAC,sBAAsB,CAAC,EAAE,oBAAoB,EAAE,IAAI,EAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChF,MAAM,CAAC,sBAAsB,CAAC,EAAE,sBAAsB,EAAE,IAAI,EAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAClF,MAAM,CAAC,sBAAsB,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7E,MAAM,CAAC,sBAAsB,CAAC,EAAE,cAAc,EAAE,IAAI,EAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC1E,MAAM,CAAC,sBAAsB,CAAC,EAAE,aAAa,EAAE,IAAI,EAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uFAAuF,EAAE,GAAG,EAAE;QAC/F,MAAM,MAAM,GAAG;YACb,iBAAiB,EAAE,MAAM;YACzB,oBAAoB,EAAE,IAAI;YAC1B,sBAAsB,EAAE,IAAI;YAC5B,iBAAiB,EAAE,IAAI;YACvB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB,CAAA;QACD,MAAM,CAAC,sBAAsB,CAAC,MAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC3D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wFAAwF,EAAE,GAAG,EAAE;QAChG,MAAM,CAAC,sBAAsB,CAAC,EAAE,iBAAiB,EAAE,QAAQ,EAAE,oBAAoB,EAAE,IAAI,EAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7G,MAAM,CAAC,sBAAsB,CAAC,EAAE,iBAAiB,EAAE,SAAS,EAAE,iBAAiB,EAAE,IAAI,EAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC7G,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,cAAc,GAAU,EAAE,CAAA;QAChC,MAAM,iBAAiB,GAAU,EAAE,CAAA;QAEnC,MAAM,eAAe;YACnB,YAAY,GAAQ,EAAE,MAAW,EAAE,GAAQ;gBACzC,cAAc,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;YAC3C,CAAC;SACF;QAED,MAAM,kBAAkB;YACtB,YAAY,GAAQ,EAAE,MAAW,EAAE,GAAQ;gBACzC,iBAAiB,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;YAC9C,CAAC;SACF;QAED,MAAM,SAAS,GAAG,mBAAmB,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAA;QAE1E,6BAA6B;QAC7B,MAAM,GAAG,GAAG,EAAE,CAAA;QACd,IAAI,SAAS,CAAC,KAAK,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,GAAG,CAAC,CAAA;QAEjD,MAAM,CAAC,cAAc,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACtC,MAAM,CAAC,iBAAiB,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,cAAc,GAAU,EAAE,CAAA;QAChC,MAAM,iBAAiB,GAAU,EAAE,CAAA;QAEnC,MAAM,eAAe;YACnB,YAAY,GAAQ,EAAE,MAAW,EAAE,GAAQ;gBACzC,cAAc,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;YAC3C,CAAC;SACF;QAED,MAAM,kBAAkB;YACtB,YAAY,GAAQ,EAAE,MAAW,EAAE,GAAQ;gBACzC,iBAAiB,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;YAC9C,CAAC;SACF;QAED,MAAM,SAAS,GAAG,mBAAmB,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAA;QAE1E,gDAAgD;QAChD,MAAM,GAAG,GAAG;YACV,MAAM,EAAE,EAAE;YACV,iBAAiB,EAAE,GAAG,EAAE,CAAC,IAAI;YAC7B,eAAe,EAAE,GAAG,EAAE,CAAC,IAAI;SAC5B,CAAA;QACD,IAAI,SAAS,CAAC,KAAK,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,GAAG,CAAC,CAAA;QAEjD,MAAM,CAAC,iBAAiB,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACzC,MAAM,CAAC,cAAc,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,cAAc,GAAU,EAAE,CAAA;QAChC,MAAM,iBAAiB,GAAU,EAAE,CAAA;QAEnC,MAAM,eAAe;YACnB,YAAY,GAAQ,EAAE,MAAW,EAAE,GAAQ;gBACzC,cAAc,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;YAC3C,CAAC;SACF;QAED,MAAM,kBAAkB;YACtB,YAAY,GAAQ,EAAE,MAAW,EAAE,GAAQ;gBACzC,iBAAiB,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;YAC9C,CAAC;SACF;QAED,MAAM,SAAS,GAAG,mBAAmB,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAA;QAE1E,0CAA0C;QAC1C,MAAM,GAAG,GAAG;YACV,MAAM,EAAE,EAAE;YACV,iBAAiB,EAAE,GAAG,EAAE,CAAC,IAAI;YAC7B,eAAe,EAAE,GAAG,EAAE,CAAC,IAAI;SAC5B,CAAA;QACD,IAAI,SAAS,CAAC,KAAK,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,GAAG,CAAC,CAAA;QAElD,MAAM,CAAC,cAAc,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACtC,MAAM,CAAC,iBAAiB,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6EAA6E,EAAE,GAAG,EAAE;QACrF,MAAM,cAAc,GAAU,EAAE,CAAA;QAChC,MAAM,iBAAiB,GAAU,EAAE,CAAA;QAEnC,MAAM,eAAe;YACnB,YAAY,GAAQ,EAAE,MAAW,EAAE,GAAQ;gBACzC,cAAc,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;YAC3C,CAAC;SACF;QAED,MAAM,kBAAkB;YACtB,YAAY,GAAQ,EAAE,MAAW,EAAE,GAAQ;gBACzC,iBAAiB,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;YAC9C,CAAC;SACF;QAED,MAAM,SAAS,GAAG,mBAAmB,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAA;QAE1E,oFAAoF;QACpF,MAAM,GAAG,GAAG;YACV,MAAM,EAAE,EAAE;SACX,CAAA;QACD,IAAI,SAAS,CAAC,KAAK,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,GAAG,CAAC,CAAA;QAEjD,MAAM,CAAC,iBAAiB,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACzC,MAAM,CAAC,cAAc,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "@homebridge-plugins/homebridge-updater",
+  "displayName": "Homebridge Updater",
+  "type": "module",
+  "version": "3.0.7",
+  "description": "A Homebridge plugin for checking for updates to Homebridge and plugins",
+  "author": "David Maher",
+  "license": "BSD-2-Clause",
+  "funding": [
+    {
+      "type": "kofi",
+      "url": "https://ko-fi.com/sunookitsune"
+    },
+    {
+      "type": "paypal",
+      "url": "https://paypal.me/sunoo"
+    },
+    {
+      "type": "github",
+      "url": "https://github.com/Sunoo"
+    },
+    {
+      "type": "liberapay",
+      "url": "https://liberapay.com/Sunoo"
+    }
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://github.com/homebridge-plugins/homebridge-updater#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/homebridge-plugins/homebridge-updater.git"
+  },
+  "bugs": {
+    "url": "https://github.com/homebridge-plugins/homebridge-updater/issues"
+  },
+  "keywords": [
+    "homebridge-plugin",
+    "plugin",
+    "update",
+    "updates",
+    "upgrade",
+    "upgrades",
+    "version",
+    "versions"
+  ],
+  "main": "dist/index.js",
+  "files": [
+    "LICENSE",
+    "README.md",
+    "config.schema.json",
+    "dist/**/*",
+    "package.json"
+  ],
+  "engines": {
+    "homebridge": "^1.11.4 || ^2.0.0-beta.111",
+    "node": "^22 || ^24"
+  },
+  "scripts": {
+    "check": "npm install && npm outdated",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "watch": "npm run build && npm run plugin-ui && npm link && nodemon",
+    "plugin-ui": "rsync ./src/homebridge-ui/public/index.html ./dist/homebridge-ui/public/",
+    "build": "npm run clean && tsc && npm run plugin-ui",
+    "prepublishOnly": "npm run lint && npm run build && npm run plugin-ui && npm run docs && npm run docs:lint",
+    "postpublish": "npm run clean && npm ci",
+    "clean": "shx rm -rf ./dist",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "test-coverage": "npm run test -- --coverage",
+    "docs": "typedoc",
+    "docs:lint": "typedoc --emit none --treatWarningsAsErrors"
+  },
+  "dependencies": {
+    "@homebridge/plugin-ui-utils": "^2.2.3",
+    "cacheable-lookup": "^7.0.0",
+    "croner": "^10.0.1",
+    "jsonwebtoken": "^9.0.3"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "^8.2.0",
+    "@types/debug": "^4.1.13",
+    "@types/node": "^25.6.0",
+    "@vitest/coverage-v8": "^4.1.5",
+    "eslint": "^10.3.0",
+    "eslint-plugin-format": "^2.0.1",
+    "homebridge": "^2.0.0-beta.111",
+    "homebridge-config-ui-x": "^5.22.0",
+    "nodemon": "^3.1.14",
+    "shx": "^0.4.0",
+    "typedoc": "^0.28.19",
+    "vitest": "^4.1.5"
+  }
+}