@switchbot/homebridge-switchbot 5.0.0-beta.11 → 5.0.0-beta.110

package/dist/homebridge-ui/server.js

@@ -1,43 +1,13 @@
-import fs from 'node:fs';
 import { HomebridgePluginUiServer } from '@homebridge/plugin-ui-utils';
-class PluginUiServer extends HomebridgePluginUiServer {
-    constructor() {
-        super();
-        /*
-          A native method getCachedAccessories() was introduced in config-ui-x v4.37.0
-          The following is for users who have a lower version of config-ui-x
-        */
-        this.onRequest('getCachedAccessories', () => {
-            try {
-                const plugin = 'homebridge-switchbot';
-                const devicesToReturn = [];
-                // The path and file of the cached accessories
-                const accFile = `${this.homebridgeStoragePath}/accessories/cachedAccessories`;
-                // Check the file exists
-                if (fs.existsSync(accFile)) {
-                    // read the cached accessories file
-                    const cachedAccessories = JSON.parse(fs.readFileSync(accFile, 'utf8'));
-                    cachedAccessories.forEach((accessory) => {
-                        // Check the accessory is from this plugin
-                        if (accessory.plugin === plugin) {
-                            // Add the cached accessory to the array
-                            devicesToReturn.push(accessory.accessory);
-                        }
-                    });
-                }
-                // Return the array
-                return devicesToReturn;
-            }
-            catch {
-                // Just return an empty accessory list in case of any errors
-                return [];
-            }
-        });
-        this.ready();
-    }
-}
-function startPluginUiServer() {
-    return new PluginUiServer();
-}
-startPluginUiServer();
+import { registerConfigEndpoints } from './endpoints/config.js';
+import { registerCredentialsEndpoint } from './endpoints/credentials.js';
+import { registerDeviceEndpoints } from './endpoints/devices.js';
+import { registerDiscoveryEndpoint } from './endpoints/discovery.js';
+const server = new HomebridgePluginUiServer();
+// Register all endpoints
+registerConfigEndpoints(server);
+registerDiscoveryEndpoint(server);
+registerDeviceEndpoints(server);
+registerCredentialsEndpoint(server);
+server.ready();
 //# sourceMappingURL=server.js.map

package/dist/homebridge-ui/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/homebridge-ui/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AAExB,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAA;AAEtE,MAAM,cAAe,SAAQ,wBAAwB;IACnD;QACE,KAAK,EAAE,CAAA;QACP;;;UAGE;QACF,IAAI,CAAC,SAAS,CAAC,sBAAsB,EAAE,GAAG,EAAE;YAC1C,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,sBAAsB,CAAA;gBACrC,MAAM,eAAe,GAAG,EAAE,CAAA;gBAE1B,8CAA8C;gBAC9C,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,qBAAqB,gCAAgC,CAAA;gBAE7E,wBAAwB;gBACxB,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC3B,mCAAmC;oBACnC,MAAM,iBAAiB,GAAU,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAA;oBAE7E,iBAAiB,CAAC,OAAO,CAAC,CAAC,SAAc,EAAE,EAAE;wBAC3C,0CAA0C;wBAC1C,IAAI,SAAS,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;4BAChC,wCAAwC;4BACxC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,SAAkB,CAAC,CAAA;wBACpD,CAAC;oBACH,CAAC,CAAC,CAAA;gBACJ,CAAC;gBACD,mBAAmB;gBACnB,OAAO,eAAe,CAAA;YACxB,CAAC;YAAC,MAAM,CAAC;gBACP,4DAA4D;gBAC5D,OAAO,EAAE,CAAA;YACX,CAAC;QACH,CAAC,CAAC,CAAA;QACF,IAAI,CAAC,KAAK,EAAE,CAAA;IACd,CAAC;CACF;AAED,SAAS,mBAAmB;IAC1B,OAAO,IAAI,cAAc,EAAE,CAAA;AAC7B,CAAC;AAED,mBAAmB,EAAE,CAAA"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/homebridge-ui/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAA;AAEtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAA;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAA;AAEpE,MAAM,MAAM,GAAG,IAAI,wBAAwB,EAAE,CAAA;AAE7C,yBAAyB;AACzB,uBAAuB,CAAC,MAAM,CAAC,CAAA;AAC/B,yBAAyB,CAAC,MAAM,CAAC,CAAA;AACjC,uBAAuB,CAAC,MAAM,CAAC,CAAA;AAC/B,2BAA2B,CAAC,MAAM,CAAC,CAAA;AAEnC,MAAM,CAAC,KAAK,EAAE,CAAA"}

package/dist/homebridge-ui/utils/config-parser.d.ts

@@ -0,0 +1,35 @@
+import type { HomebridgePluginUiServer } from '@homebridge/plugin-ui-utils';
+export declare const SWITCHBOT_PLATFORM_REGEX: RegExp;
+/**
+ * Get reference to the devices array in platform config
+ */
+export declare function getDevicesRef(platform: any): any[];
+/**
+ * Get all device arrays from platform config
+ */
+export declare function getDeviceArrays(platform: any): any[][];
+/**
+ * Get all unique devices from platform config
+ */
+export declare function getAllDevices(platform: any): any[];
+/**
+ * Get credential from platform config
+ */
+export declare function getCredential(platform: any, key: 'openApiToken' | 'openApiSecret'): string | undefined;
+/**
+ * Set credential in platform config
+ */
+export declare function setCredential(platform: any, key: 'openApiToken' | 'openApiSecret', value: string): void;
+/**
+ * Find and parse the SwitchBot platform config from Homebridge config file
+ */
+export declare function getSwitchBotPlatformConfig(server: HomebridgePluginUiServer): Promise<{
+    platform: any;
+    cfg: any;
+    cfgPath: string;
+}>;
+/**
+ * Save the Homebridge config file
+ */
+export declare function saveConfig(cfgPath: string, cfg: any): Promise<void>;
+//# sourceMappingURL=config-parser.d.ts.map

package/dist/homebridge-ui/utils/config-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-parser.d.ts","sourceRoot":"","sources":["../../../src/homebridge-ui/utils/config-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAA;AAO3E,eAAO,MAAM,wBAAwB,QAAe,CAAA;AAEpD;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,GAAG,GAAG,GAAG,EAAE,CAWlD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,GAAG,GAAG,GAAG,EAAE,EAAE,CAGtD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,GAAG,GAAG,GAAG,EAAE,CAYlD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,cAAc,GAAG,eAAe,GAAG,MAAM,GAAG,SAAS,CAEtG;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,cAAc,GAAG,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAMvG;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,MAAM,EAAE,wBAAwB;;;;GA6BhF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzE"}

package/dist/homebridge-ui/utils/config-parser.js

@@ -0,0 +1,87 @@
+import fs from 'node:fs/promises';
+import { uiLog } from './logger.js';
+// Module-scope regex pattern to avoid recompilation
+export const SWITCHBOT_PLATFORM_REGEX = /switchbot/i;
+/**
+ * Get reference to the devices array in platform config
+ */
+export function getDevicesRef(platform) {
+    if (!platform || typeof platform !== 'object') {
+        return [];
+    }
+    if (Array.isArray(platform.devices)) {
+        return platform.devices;
+    }
+    platform.devices = [];
+    return platform.devices;
+}
+/**
+ * Get all device arrays from platform config
+ */
+export function getDeviceArrays(platform) {
+    const rootDevices = getDevicesRef(platform);
+    return [rootDevices];
+}
+/**
+ * Get all unique devices from platform config
+ */
+export function getAllDevices(platform) {
+    const all = getDevicesRef(platform);
+    const seen = new Set();
+    return all.filter((d) => {
+        const id = String(d?.deviceId ?? d?.id ?? '').trim().toLowerCase();
+        if (!id || seen.has(id)) {
+            return false;
+        }
+        seen.add(id);
+        return true;
+    });
+}
+/**
+ * Get credential from platform config
+ */
+export function getCredential(platform, key) {
+    return platform?.[key];
+}
+/**
+ * Set credential in platform config
+ */
+export function setCredential(platform, key, value) {
+    if (!platform || typeof platform !== 'object') {
+        return;
+    }
+    platform[key] = value;
+}
+/**
+ * Find and parse the SwitchBot platform config from Homebridge config file
+ */
+export async function getSwitchBotPlatformConfig(server) {
+    const cfgPath = server.homebridgeConfigPath;
+    if (!cfgPath) {
+        throw new Error('HOMEBRIDGE_CONFIG_PATH not set');
+    }
+    const raw = await fs.readFile(cfgPath, 'utf-8');
+    const cfg = JSON.parse(raw);
+    const platforms = Array.isArray(cfg.platforms) ? cfg.platforms : [];
+    const candidates = platforms.filter((p) => {
+        const platformName = p.platform || p.name || '';
+        return !!platformName && (SWITCHBOT_PLATFORM_REGEX.test(String(platformName)) || String(platformName).toLowerCase() === '@switchbot/homebridge-switchbot');
+    });
+    uiLog.info(`Found ${candidates.length} SwitchBot candidate(s)`);
+    const platform = candidates.find((p) => {
+        const name = String(p.platform || '').toLowerCase();
+        return name === 'switchbot' || name.includes('switchbot');
+    });
+    if (!platform) {
+        throw new Error('SwitchBot platform not found in config. Please add the plugin configuration first.');
+    }
+    uiLog.info(`Using SwitchBot platform: ${platform.name || platform.platform || 'SwitchBot'}`);
+    return { platform, cfg, cfgPath };
+}
+/**
+ * Save the Homebridge config file
+ */
+export async function saveConfig(cfgPath, cfg) {
+    await fs.writeFile(cfgPath, JSON.stringify(cfg, null, 2), 'utf-8');
+}
+//# sourceMappingURL=config-parser.js.map

package/dist/homebridge-ui/utils/config-parser.js.map

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

package/dist/homebridge-ui/utils/device-migration.d.ts

@@ -0,0 +1,35 @@
+export interface DeviceMigrationResult {
+    migrated: boolean;
+    originalType: string | undefined;
+    correctedType: string | null;
+    message: string;
+}
+/**
+ * Validate and optionally correct a device's configDeviceType
+ * @param device Device object from config
+ * @param autoCorrect Whether to auto-correct invalid types
+ * @returns Migration result with details
+ */
+export declare function validateAndMigrateDeviceType(device: any, autoCorrect?: boolean): DeviceMigrationResult;
+/**
+ * Validate all devices in config and optionally auto-correct invalid types
+ * @param config Configuration object containing devices array
+ * @param autoCorrect Whether to auto-correct invalid types
+ * @returns Array of migration results with statistics
+ */
+export declare function validateAndMigrateConfig(config: any, autoCorrect?: boolean): {
+    results: DeviceMigrationResult[];
+    statistics: {
+        total: number;
+        valid: number;
+        corrected: number;
+        invalid: number;
+    };
+    warnings: string[];
+};
+/**
+ * Get list of all valid device types for error messages
+ * @returns Array of valid device types grouped by category
+ */
+export declare function getValidDeviceTypesList(): Record<string, readonly string[]>;
+//# sourceMappingURL=device-migration.d.ts.map

package/dist/homebridge-ui/utils/device-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-migration.d.ts","sourceRoot":"","sources":["../../../src/homebridge-ui/utils/device-migration.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,OAAO,CAAA;IACjB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,GAAG,EACX,WAAW,UAAQ,GAClB,qBAAqB,CA2CvB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,GAAG,EACX,WAAW,UAAQ,GAClB;IACD,OAAO,EAAE,qBAAqB,EAAE,CAAA;IAChC,UAAU,EAAE;QACV,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,CAAA;QACb,SAAS,EAAE,MAAM,CAAA;QACjB,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB,CAsDA;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAE3E"}

package/dist/homebridge-ui/utils/device-migration.js

@@ -0,0 +1,111 @@
+import { DEVICE_TYPES, isValidDeviceType, normalizeDeviceType } from '../../device-types.js';
+/**
+ * Validate and optionally correct a device's configDeviceType
+ * @param device Device object from config
+ * @param autoCorrect Whether to auto-correct invalid types
+ * @returns Migration result with details
+ */
+export function validateAndMigrateDeviceType(device, autoCorrect = false) {
+    const originalType = device.configDeviceType;
+    const deviceId = device.deviceId || device.id || 'unknown';
+    // Check if type is valid
+    if (isValidDeviceType(originalType)) {
+        return {
+            migrated: false,
+            originalType,
+            correctedType: originalType,
+            message: `Device "${device.configDeviceName || deviceId}" type is valid`,
+        };
+    }
+    // Try to find a valid mapping
+    const correctedType = normalizeDeviceType(originalType);
+    if (!correctedType) {
+        return {
+            migrated: false,
+            originalType,
+            correctedType: null,
+            message: `Device "${device.configDeviceName || deviceId}" has invalid type "${originalType}" with no valid mapping`,
+        };
+    }
+    // Found a valid mapping
+    if (autoCorrect) {
+        device.configDeviceType = correctedType;
+        return {
+            migrated: true,
+            originalType,
+            correctedType,
+            message: `Device "${device.configDeviceName || deviceId}" type auto-corrected: "${originalType}" → "${correctedType}"`,
+        };
+    }
+    else {
+        return {
+            migrated: false,
+            originalType,
+            correctedType,
+            message: `Device "${device.configDeviceName || deviceId}" requires migration: "${originalType}" → "${correctedType}"`,
+        };
+    }
+}
+/**
+ * Validate all devices in config and optionally auto-correct invalid types
+ * @param config Configuration object containing devices array
+ * @param autoCorrect Whether to auto-correct invalid types
+ * @returns Array of migration results with statistics
+ */
+export function validateAndMigrateConfig(config, autoCorrect = false) {
+    const results = [];
+    const warnings = [];
+    let validCount = 0;
+    let correctedCount = 0;
+    let invalidCount = 0;
+    if (!config?.devices || !Array.isArray(config.devices)) {
+        return {
+            results,
+            statistics: {
+                total: 0,
+                valid: 0,
+                corrected: 0,
+                invalid: 0,
+            },
+            warnings: ['No devices found in config'],
+        };
+    }
+    for (const device of config.devices) {
+        const result = validateAndMigrateDeviceType(device, autoCorrect);
+        results.push(result);
+        if (!result.originalType || isValidDeviceType(result.originalType)) {
+            validCount++;
+        }
+        else if (result.migrated) {
+            correctedCount++;
+        }
+        else if (result.correctedType) {
+            warnings.push(`Device "${device.configDeviceName || device.deviceId}" needs correction: "${result.originalType}" → "${result.correctedType}"`);
+            invalidCount++;
+        }
+        else {
+            invalidCount++;
+            warnings.push(`Device "${device.configDeviceName || device.deviceId}" has INVALID type "${result.originalType}" with no mapping`);
+        }
+    }
+    // Validation complete - results and warnings are returned via return value
+    // Caller (config endpoint) will handle logging/reporting
+    return {
+        results,
+        statistics: {
+            total: config.devices.length,
+            valid: validCount,
+            corrected: correctedCount,
+            invalid: invalidCount,
+        },
+        warnings,
+    };
+}
+/**
+ * Get list of all valid device types for error messages
+ * @returns Array of valid device types grouped by category
+ */
+export function getValidDeviceTypesList() {
+    return DEVICE_TYPES;
+}
+//# sourceMappingURL=device-migration.js.map

package/dist/homebridge-ui/utils/device-migration.js.map

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

package/dist/homebridge-ui/utils/logger.d.ts

@@ -0,0 +1,7 @@
+export declare const uiLog: {
+    info: (message: string, ...parameters: any[]) => void;
+    warn: (message: string, ...parameters: any[]) => void;
+    error: (message: string, ...parameters: any[]) => void;
+    debug: (message: string, ...parameters: any[]) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/homebridge-ui/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/homebridge-ui/utils/logger.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,KAAK;oBACA,MAAM,iBAAiB,GAAG,EAAE;oBAG5B,MAAM,iBAAiB,GAAG,EAAE;qBAG3B,MAAM,iBAAiB,GAAG,EAAE;qBAG5B,MAAM,iBAAiB,GAAG,EAAE;CAG9C,CAAA"}

package/dist/homebridge-ui/utils/logger.js

@@ -0,0 +1,17 @@
+/* eslint-disable no-console */
+const PREFIX = '[SwitchBot UI]';
+export const uiLog = {
+    info: (message, ...parameters) => {
+        console.log(PREFIX, message, ...parameters);
+    },
+    warn: (message, ...parameters) => {
+        console.warn(PREFIX, message, ...parameters);
+    },
+    error: (message, ...parameters) => {
+        console.error(PREFIX, message, ...parameters);
+    },
+    debug: (message, ...parameters) => {
+        console.debug(PREFIX, message, ...parameters);
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/homebridge-ui/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/homebridge-ui/utils/logger.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,MAAM,MAAM,GAAG,gBAAgB,CAAA;AAE/B,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,UAAiB,EAAE,EAAE;QAC9C,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,CAAC,CAAA;IAC7C,CAAC;IACD,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,UAAiB,EAAE,EAAE;QAC9C,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,CAAC,CAAA;IAC9C,CAAC;IACD,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,UAAiB,EAAE,EAAE;QAC/C,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,CAAC,CAAA;IAC/C,CAAC;IACD,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,UAAiB,EAAE,EAAE;QAC/C,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,CAAC,CAAA;IAC/C,CAAC;CACF,CAAA"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;yBAOrB,KAAK,GAAG,KAAG,IAAI;AAA/B,wBAiEC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;yBAOrB,KAAK,GAAG,KAAG,IAAI;AAA/B,wBAGC"}

package/dist/index.js

@@ -1,70 +1,9 @@
-import { SwitchBotHAPPlatform } from './platform-hap.js';
-import { SwitchBotMatterPlatform } from './platform-matter.js';
+import { SwitchBotHAPPlatform, SwitchBotMatterPlatform } from './platform.js';
 import { PLATFORM_NAME, PLUGIN_NAME } from './settings.js';
+import { createPlatformProxy } from './utils.js';
 // Register our platform with homebridge.
 export default (api) => {
-    // Register a single proxy platform class. Homebridge will instantiate this class
-    // with (log, config, api) and we delegate to the appropriate actual platform
-    // implementation (HAP or Matter) based on runtime detection. This avoids
-    // registering two platforms and possible conflicts.
-    // Compact helper to determine if Matter should be used.
-    const detectMatter = (apiObj) => {
-        try {
-            const maybe = apiObj.isMatterEnabled;
-            if (typeof maybe === 'function') {
-                return Boolean(maybe.call(apiObj));
-            }
-            if (typeof maybe !== 'undefined') {
-                return Boolean(maybe);
-            }
-            const server = apiObj.server ?? apiObj.homebridgeServer ?? apiObj.homebridge_server;
-            const serverMaybe = server?.isMatterEnabled;
-            if (typeof serverMaybe === 'function') {
-                return Boolean(serverMaybe.call(server));
-            }
-            if (typeof server?.isMatterEnabled !== 'undefined') {
-                return Boolean(server.isMatterEnabled);
-            }
-        }
-        catch (e) {
-            // ignore
-        }
-        return false;
-    };
-    class SwitchBotPlatformProxy {
-        log;
-        config;
-        api;
-        delegate;
-        constructor(log, config, api) {
-            this.log = log;
-            this.config = config;
-            this.api = api;
-            const isMatter = detectMatter(this.api);
-            this.log.info?.(`Homebridge SwitchBot Plugin initializing in ${isMatter ? 'Matter' : 'HAP'} mode.`);
-            const PlatformCtor = isMatter ? SwitchBotMatterPlatform : SwitchBotHAPPlatform;
-            this.delegate = new PlatformCtor(this.log, this.config, this.api);
-        }
-        // Homebridge lifecycle hooks we expect to be called — delegate if available.
-        configureAccessory(accessory) {
-            if (typeof this.delegate.configureAccessory === 'function') {
-                return this.delegate.configureAccessory(accessory);
-            }
-        }
-        configureMatterAccessory(accessory) {
-            if (typeof this.delegate.configureMatterAccessory === 'function') {
-                return this.delegate.configureMatterAccessory(accessory);
-            }
-        }
-        // Expose common properties via getters for external access
-        get accessories() {
-            return this.delegate?.accessories;
-        }
-        get matterAccessories() {
-            return this.delegate?.matterAccessories;
-        }
-    }
-    // Register the proxy class with Homebridge. Homebridge will call `new SwitchBotPlatformProxy(log, config, api)`
-    api.registerPlatform(PLUGIN_NAME, PLATFORM_NAME, SwitchBotPlatformProxy);
+    const ProxyCtor = createPlatformProxy(SwitchBotHAPPlatform, SwitchBotMatterPlatform);
+    api.registerPlatform(PLUGIN_NAME, PLATFORM_NAME, ProxyCtor);
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAC7E,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAEhD,yCAAyC;AACzC,eAAe,CAAC,GAAQ,EAAQ,EAAE;IAChC,MAAM,SAAS,GAAG,mBAAmB,CAAC,oBAAoB,EAAE,uBAAuB,CAAC,CAAA;IACpF,GAAG,CAAC,gBAAgB,CAAC,WAAW,EAAE,aAAa,EAAE,SAAgB,CAAC,CAAA;AACpE,CAAC,CAAA"}

package/dist/platform.d.ts

@@ -0,0 +1,35 @@
+import type { SwitchBotPluginConfig } from './settings.js';
+import type { API, Logger, PlatformConfig } from 'homebridge';
+export declare class SwitchBotHAPPlatform {
+    api: API | undefined;
+    log: Logger;
+    config: SwitchBotPluginConfig;
+    devices: any[];
+    accessories: Map<string, any>;
+    private lastConfigHash;
+    private configReloadInterval;
+    constructor(log: Logger, config: PlatformConfig, api?: API);
+    private getConfigHash;
+    private checkAndReloadDevices;
+    loadDevices(): Promise<void>;
+    configureAccessory(accessory: any): Promise<void>;
+    configureMatterAccessory?(accessory: any): void;
+}
+export declare class SwitchBotMatterPlatform {
+    api: API | undefined;
+    log: Logger;
+    config: SwitchBotPluginConfig;
+    devices: any[];
+    accessories: Map<string, any>;
+    private lastConfigHash;
+    private configReloadInterval;
+    constructor(log: Logger, config: PlatformConfig, api?: API);
+    loadDevices(): Promise<void>;
+    private getConfigHash;
+    private checkAndReloadDevices;
+    configureAccessory(accessory: any): Promise<void>;
+    configureMatterAccessory(accessory: any): void;
+    registerMatterAccessories(): Promise<void>;
+}
+export default SwitchBotHAPPlatform;
+//# sourceMappingURL=platform.d.ts.map

package/dist/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAC1D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAk7B7D,qBAAa,oBAAoB;IAC/B,GAAG,EAAE,GAAG,GAAG,SAAS,CAAA;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,qBAAqB,CAAA;IAC7B,OAAO,EAAE,GAAG,EAAE,CAAK;IAEnB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAE7B,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,oBAAoB,CAA8B;gBAE9C,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,GAAG;IA2C1D,OAAO,CAAC,aAAa;YAUP,qBAAqB;IAU7B,WAAW;IAqMX,kBAAkB,CAAC,SAAS,EAAE,GAAG;IAYvC,wBAAwB,CAAC,CAAC,SAAS,EAAE,GAAG;CASzC;AAGD,qBAAa,uBAAuB;IAClC,GAAG,EAAE,GAAG,GAAG,SAAS,CAAA;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,qBAAqB,CAAA;IAC7B,OAAO,EAAE,GAAG,EAAE,CAAK;IACnB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAE7B,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,oBAAoB,CAA8B;gBAE9C,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,GAAG;IA8CpD,WAAW;IAyEjB,OAAO,CAAC,aAAa;YAUP,qBAAqB;IAU7B,kBAAkB,CAAC,SAAS,EAAE,GAAG;IAWvC,wBAAwB,CAAC,SAAS,EAAE,GAAG;IAWjC,yBAAyB;CAsJhC;AAED,eAAe,oBAAoB,CAAA"}