@switchbot/homebridge-switchbot 5.0.0-beta.147 → 5.0.0-beta.149

package/.github/workflows/ci.yml

@@ -11,7 +11,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [20, 22]
+        node-version: [22, 24]
 
     steps:
       - uses: actions/checkout@v4

package/.github/workflows/manual-e2e.yml

@@ -43,12 +43,12 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Setup Node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
-          node-version: '18'
+          node-version: '22'
 
       - name: Install dependencies
         run: npm ci --prefer-offline --no-audit --progress=false

package/config.schema.json

@@ -27,6 +27,12 @@
         "description": "Optional OpenAPI secret for certain account setups.",
         "format": "password"
       },
+      "enableBLE": {
+        "type": "boolean",
+        "title": "Enable BLE (Bluetooth)",
+        "description": "Enable or disable BLE (Bluetooth Low Energy) support. If disabled, only OpenAPI (cloud) will be used.",
+        "default": true
+      },
       "devices": {
         "type": "array",
         "title": "Devices",

package/dist/SwitchBotHAPPlatform.d.ts

@@ -0,0 +1,133 @@
+import type { SwitchBotPluginConfig } from './settings.js';
+import type { API, Logger, PlatformConfig } from 'homebridge';
+/**
+ * Homebridge platform class for SwitchBot HAP (HomeKit Accessory Protocol) integration.
+ * Handles device discovery, registration, polling, and accessory lifecycle for HAP-enabled SwitchBot devices.
+ *
+ * @class SwitchBotHAPPlatform
+ * @param {Logger} log - Homebridge logger instance
+ * @param {PlatformConfig} config - Platform configuration object
+ * @param {API} [api] - Optional Homebridge API instance
+ * @property {API | undefined} api - Homebridge API instance
+ * @property {Logger} log - Homebridge logger instance
+ * @property {SwitchBotPluginConfig} config - Parsed plugin config
+ * @property {any[]} devices - All created device instances
+ * @property {Map<string, any>} accessories - Map of accessory UUID to accessory object
+ * @property {string} lastConfigHash - Hash of last loaded config for change detection
+ * @property {NodeJS.Timeout | null} configReloadInterval - Interval for periodic config reload
+ * @property {Map<string, NodeJS.Timeout>} openApiPollTimers - Timers for per-device OpenAPI polling
+ * @property {NodeJS.Timeout | null} openApiBatchTimer - Timer for batched OpenAPI polling
+ * @property {number} openApiRequestsToday - Count of OpenAPI requests made today
+ * @property {number} openApiLastReset - Timestamp (ms) of last OpenAPI daily counter reset
+ */
+export declare class SwitchBotHAPPlatform {
+    /** Homebridge API instance */
+    api: API | undefined;
+    /** Homebridge logger instance */
+    log: Logger;
+    /** Parsed plugin config */
+    config: SwitchBotPluginConfig;
+    /** All created device instances */
+    devices: any[];
+    /** Map of accessory UUID to accessory object */
+    accessories: Map<string, any>;
+    /** Hash of last loaded config for change detection */
+    private lastConfigHash;
+    /** Interval for periodic config reload */
+    private configReloadInterval;
+    /** Timers for per-device OpenAPI polling */
+    private openApiPollTimers;
+    /** Timer for batched OpenAPI polling */
+    private openApiBatchTimer;
+    /** Count of OpenAPI requests made today */
+    private openApiRequestsToday;
+    /** Timestamp (ms) of last OpenAPI daily counter reset */
+    private openApiLastReset;
+    /**
+     * Construct the SwitchBot HAP platform.
+     * @param log Homebridge logger
+     * @param config Platform config
+     * @param api Homebridge API instance
+     */
+    constructor(log: Logger, config: PlatformConfig, api?: API);
+    /**
+     * Discover and create all device instances from config.
+     * Populates this.devices and registers HAP accessories for each device.
+     * Ensures Matter API is loaded before loading devices if available.
+     *
+     * @returns {Promise<void>} Resolves when all devices are loaded and registered
+     */
+    loadDevices(): Promise<void>;
+    /**
+     * Registers all HAP accessories with the Homebridge HAP API.
+     *
+     * This method is called after all device instances have been created. It handles both new and restored
+     * accessories, updating their context and adding or updating HAP services and characteristics as needed.
+     * Accessories are registered with Homebridge using the HAP API, and the internal accessory map is updated accordingly.
+     *
+     * @param {Array<{created: any, d: any, type: string}>} createdDevices - Array of device descriptors:
+     *   - created: The created device instance
+     *   - d: The normalized device config object
+     *   - type: The normalized device type string
+     * @returns {Promise<void>} Resolves when registration is complete
+     *
+     * Differences from Matter registration:
+     *   - Uses the HAP API (not Matter API) for accessory registration.
+     *   - Adds HAP services and characteristics to each accessory based on the device descriptor.
+     *   - Does not require or check for Matter support or availability.
+     *   - Accessory context and service wiring are HAP-specific.
+     *
+     * If the Homebridge HAP API is not available, registration is skipped and a log message is emitted.
+     */
+    private registerHAPAccessories;
+    /**
+     * Returns the timestamp (ms) of the last OpenAPI daily counter reset.
+     * @returns {number} Timestamp in ms
+     */
+    getOpenApiLastReset(): number;
+    /**
+     * Logs the last OpenAPI reset time in a human-readable format.
+     * @returns {void}
+     */
+    logOpenApiLastReset(): void;
+    /**
+     * Compute a hash of the current device config for change detection.
+     * @returns {string} JSON string hash of device config
+     */
+    private getConfigHash;
+    /**
+     * Reload devices if config has changed since last load.
+     * Unregisters accessories and removes devices no longer in config.
+     * Calls loadDevices to repopulate devices and accessories.
+     *
+     * @returns {Promise<void>} Resolves when reload is complete
+     */
+    private checkAndReloadDevices;
+    /**
+     * Cleanup method to clear config reload interval on shutdown.
+     * Called by Homebridge on shutdown event.
+     * @returns {void}
+     */
+    shutdown(): void;
+    /**
+     * Setup OpenAPI polling for all devices according to config (global, per-device, batch, rate limit).
+     * Handles daily request limits, per-device and batch polling, and resets.
+     *
+     * @returns {void}
+     */
+    private _setupOpenApiPolling;
+    /**
+     * Called by Homebridge to restore cached HAP accessories on startup.
+     * @param {any} accessory - The cached accessory object
+     * @returns {Promise<void>} Resolves when accessory is restored
+     */
+    configureAccessory(accessory: any): Promise<void>;
+    /**
+     * Called by Homebridge when a cached Matter accessory is restored (optional signature).
+     * @param {any} accessory - The cached accessory object
+     * @returns {void}
+     */
+    configureMatterAccessory?(accessory: any): void;
+}
+export default SwitchBotHAPPlatform;
+//# sourceMappingURL=SwitchBotHAPPlatform.d.ts.map

package/dist/SwitchBotHAPPlatform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SwitchBotHAPPlatform.d.ts","sourceRoot":"","sources":["../src/SwitchBotHAPPlatform.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;AAO7D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,oBAAoB;IAC/B,8BAA8B;IAC9B,GAAG,EAAE,GAAG,GAAG,SAAS,CAAA;IACpB,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,2BAA2B;IAC3B,MAAM,EAAE,qBAAqB,CAAA;IAC7B,mCAAmC;IACnC,OAAO,EAAE,GAAG,EAAE,CAAK;IACnB,gDAAgD;IAChD,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC7B,sDAAsD;IACtD,OAAO,CAAC,cAAc,CAAa;IACnC,0CAA0C;IAC1C,OAAO,CAAC,oBAAoB,CAA8B;IAC1D,4CAA4C;IAC5C,OAAO,CAAC,iBAAiB,CAAyC;IAClE,wCAAwC;IACxC,OAAO,CAAC,iBAAiB,CAA8B;IACvD,2CAA2C;IAC3C,OAAO,CAAC,oBAAoB,CAAI;IAChC,yDAAyD;IACzD,OAAO,CAAC,gBAAgB,CAAI;IAE5B;;;;;OAKG;gBACS,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,GAAG;IA2C1D;;;;;;OAMG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IA6DlC;;;;;;;;;;;;;;;;;;;;OAoBG;YACW,sBAAsB;IAgHpC;;;OAGG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;;OAGG;IACH,mBAAmB,IAAI,IAAI;IAS3B;;;OAGG;IACH,OAAO,CAAC,aAAa;IAUrB;;;;;;OAMG;YACW,qBAAqB;IAiCnC;;;;OAIG;IACH,QAAQ,IAAI,IAAI;IAQhB;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAkI5B;;;;OAIG;IACG,kBAAkB,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvD;;;;OAIG;IACH,wBAAwB,CAAC,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI;CAShD;AAED,eAAe,oBAAoB,CAAA"}