@switchbot/homebridge-switchbot 5.0.0-beta.7 → 5.0.0-beta.70

package/dist/platform-matter.d.ts

@@ -1,12 +1,6 @@
 import type { API, DynamicPlatformPlugin, Logging, SerializedMatterAccessory } from 'homebridge';
 import type { bodyChange, device } from 'node-switchbot';
 import type { SwitchBotPlatformConfig } from './settings.js';
-/**
- * MatterPlatform
- * Demonstrates all available Matter device types in Homebridge
- *
- * Organized by official Matter Specification v1.4.1 categories
- */
 export declare class SwitchBotMatterPlatform implements DynamicPlatformPlugin {
     readonly log: Logging;
     readonly config: SwitchBotPlatformConfig;
@@ -15,8 +9,57 @@ export declare class SwitchBotMatterPlatform implements DynamicPlatformPlugin {
     private switchBotAPI?;
     private switchBotBLE?;
     private discoveredDevices;
+    private discoveredIRDevices;
+    private accessoryInstances;
+    private refreshTimers;
+    private platformRefreshTimer?;
+    private deviceStatusCache;
+    private backoffCooldowns;
+    private backoffFilePath?;
+    private perDeviceRefreshSet;
     private bleEventHandler;
+    private mqttClient;
+    private webhookEventListener;
+    private webhookEventHandler;
+    private platformLogging?;
+    private apiTracker?;
+    infoLog: (...args: any[]) => void;
+    successLog: (...args: any[]) => void;
+    debugSuccessLog: (...args: any[]) => void;
+    warnLog: (...args: any[]) => void;
+    debugWarnLog: (...args: any[]) => void;
+    errorLog: (...args: any[]) => void;
+    debugErrorLog: (...args: any[]) => void;
+    debugLog: (...args: any[]) => void;
+    loggingIsDebug: () => Promise<boolean>;
+    enablingPlatformLogging: () => Promise<boolean>;
     constructor(log: Logging, config: SwitchBotPlatformConfig, api: API);
+    /**
+     * Normalize a deviceId for matching (uppercase alphanumerics only)
+     * @deprecated Use shared normalizeDeviceId from utils.js instead
+     */
+    private normalizeDeviceId;
+    /** Determine the platform-level batch interval in seconds */
+    private getPlatformBatchInterval;
+    /**
+     * Clear per-device resources: refresh timers, accessory instance registry, BLE handlers
+     */
+    private clearDeviceResources;
+    /**
+     * Merge discovered devices with per-device overrides from `config.options.devices`.
+     * Also applies device-type templates when applyToAllDevicesOfType is set.
+     */
+    private mergeDiscoveredDevices;
+    /**
+     * Merge discovered IR devices with per-device overrides from `config.options.irdevices`.
+     * Also applies device-type templates when applyToAllDevicesOfType is set.
+     */
+    private mergeDiscoveredIRDevices;
+    /**
+     * Select effective connection type for a device: prefer explicit device.connectionType,
+     * otherwise prefer BLE when platform BLE is enabled and device provides a BLE model/id.
+     */
+    private chooseConnectionType;
     /**
      * Map a SwitchBot device object to a MatterAccessory using the device-specific
      * Matter accessory classes in `src/devices-matter`.
@@ -26,6 +69,16 @@ export declare class SwitchBotMatterPlatform implements DynamicPlatformPlugin {
      * Discover devices via SwitchBot OpenAPI and cache them for later use
      */
     private discoverDevices;
+    /**
+     * Setup MQTT connection (if configured) and route incoming webhook messages
+     * to registered webhook handlers. Mirrors behaviour in platform-hap.
+     */
+    setupMqtt(): Promise<void>;
+    /**
+     * Setup OpenAPI webhook (if webhookURL configured) and forward incoming
+     * webhook events to MQTT (if configured) and local handlers.
+     */
+    setupwebhook(): Promise<void>;
     /**
      * Retry wrapper for control commands using SwitchBot OpenAPI
      */
@@ -38,6 +91,17 @@ export declare class SwitchBotMatterPlatform implements DynamicPlatformPlugin {
      * Returns null when serviceData is falsy or parsing fails.
      */
     private parseAdvertisementForDevice;
+    /**
+     * Central helper to apply a SwitchBot status object to a Matter accessory.
+     * Tries to call accessory instance update helpers when available, otherwise
+     * falls back to calling api.matter.updateAccessoryState directly.
+     */
+    private applyStatusToAccessory;
+    /**
+     * Apply status update with a small retry if the accessory is not yet registered.
+     * Useful for first-time updates that can race with registration.
+     */
+    private applyStatusWithRegistrationRetry;
     /**
      * Required for DynamicPlatformPlugin
      * Called when homebridge restores cached accessories from disk at startup
@@ -54,6 +118,11 @@ export declare class SwitchBotMatterPlatform implements DynamicPlatformPlugin {
      * Register all Matter accessories
      */
     private registerMatterAccessories;
+    /**
+     * Restore webhook handlers for cached Matter accessories
+     * This ensures webhook functionality continues to work even when device discovery fails
+     */
+    private restoreCachedMatterAccessoryWebhooks;
     /**
      * Remove accessories that are disabled in config
      */
@@ -97,5 +166,23 @@ export declare class SwitchBotMatterPlatform implements DynamicPlatformPlugin {
      * like managing multiple logical components within a single device.
      */
     private registerCustomDevices;
+    /**
+     * Start platform-level refresh timer to batch all device status updates
+     */
+    private startPlatformRefreshTimer;
+    /**
+     * Batch refresh all devices - still makes individual API calls but batches them together
+     * Note: SwitchBot API doesn't support true batch status calls, but we can parallelize them
+     */
+    private batchRefreshAllDevices;
+    /** Refresh a single device with retry and backoff; returns status object if successful */
+    private refreshSingleDeviceWithRetry;
+    /**
+     * Validate that the user's configuration won't exceed API limits
+     * Warn if device count × polling frequency will hit daily limits
+     */
+    private validateApiUsageConfig;
+    /** Simple concurrency limiter for an array of items */
+    private runWithConcurrency;
 }
 //# sourceMappingURL=platform-matter.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"platform-matter.d.ts","sourceRoot":"","sources":["../src/platform-matter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,GAAG,EACH,qBAAqB,EACrB,OAAO,EAEP,yBAAyB,EAC1B,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAExD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AA8B5D;;;;;GAKG;AACH,qBAAa,uBAAwB,YAAW,qBAAqB;aAgBjD,GAAG,EAAE,OAAO;aACZ,MAAM,EAAE,uBAAuB;aAC/B,GAAG,EAAE,GAAG;IAZ1B,SAAgB,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAY;IAErF,OAAO,CAAC,YAAY,CAAC,CAAkB;IACvC,OAAO,CAAC,YAAY,CAAC,CAAc;IAEnC,OAAO,CAAC,iBAAiB,CAAe;IAExC,OAAO,CAAC,eAAe,CAA8C;gBAGnD,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,uBAAuB,EAC/B,GAAG,EAAE,GAAG;IA4F1B;;;OAGG;YACW,yBAAyB;IAkVvC;;OAEG;YACW,eAAe;IAwB7B;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,SAAI,EAAE,mBAAmB,SAAO,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,GAAG,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IA0BzJ;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAwDnC;;;OAGG;IACH,kBAAkB;IAMlB;;;;;OAKG;IACH,wBAAwB,CAAC,SAAS,EAAE,yBAAyB;IAK7D;;OAEG;YACW,yBAAyB;IAgDvC;;OAEG;YACW,yBAAyB;IAqCvC;;OAEG;YACW,wBAAwB;IA8CtC;;OAEG;YACW,0BAA0B;IAsBxC;;OAEG;YACW,wBAAwB;IAsBtC;;OAEG;YACW,uBAAuB;IA0DrC;;OAEG;YACW,uBAAuB;IAkCrC;;OAEG;YACW,oBAAoB;IA4BlC;;;;;OAKG;YACW,wBAAwB;IAsBtC;;;;;;OAMG;YACW,qBAAqB;CAqBpC"}
+{"version":3,"file":"platform-matter.d.ts","sourceRoot":"","sources":["../src/platform-matter.ts"],"names":[],"mappings":"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"}