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

package/dist/platform-matter.d.ts

@@ -11,11 +11,15 @@ export declare class SwitchBotMatterPlatform implements DynamicPlatformPlugin {
     private discoveredDevices;
     private accessoryInstances;
     private refreshTimers;
+    private platformRefreshTimer?;
+    private deviceStatusCache;
+    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;
@@ -31,6 +35,8 @@ export declare class SwitchBotMatterPlatform implements DynamicPlatformPlugin {
      * Normalize a deviceId for matching (uppercase alphanumerics only)
      */
     private normalizeDeviceId;
+    /** Determine the platform-level batch interval in seconds */
+    private getPlatformBatchInterval;
     /**
      * Clear per-device resources: refresh timers, accessory instance registry, BLE handlers
      */
@@ -146,5 +152,18 @@ 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;
+    /** 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":"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"}
+{"version":3,"file":"platform-matter.d.ts","sourceRoot":"","sources":["../src/platform-matter.ts"],"names":[],"mappings":"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"}

package/dist/platform-matter.js

@@ -2,7 +2,7 @@ import asyncmqtt from 'async-mqtt';
 import { SwitchBotBLE, SwitchBotOpenAPI } from 'node-switchbot';
 import { ColorLightAccessory, ColorTemperatureLightAccessory, ContactSensorAccessory, DimmableLightAccessory, DoorLockAccessory, ExtendedColorLightAccessory, FanAccessory, HumiditySensorAccessory, LeakSensorAccessory, LightSensorAccessory, OccupancySensorAccessory, OnOffLightAccessory, OnOffOutletAccessory, OnOffSwitchAccessory, PowerStripAccessory, RoboticVacuumAccessory, SmokeCOAlarmAccessory, TemperatureSensorAccessory, ThermostatAccessory, VenetianBlindAccessory, WindowBlindAccessory, } from './devices-matter/index.js';
 import { PLATFORM_NAME, PLUGIN_NAME } from './settings.js';
-import { cleanDeviceConfig, createPlatformLogger, formatDeviceIdAsMac, hs2rgb, makeBLESender, makeOpenAPISender, rgb2hs, sleep } from './utils.js';
+import { ApiRequestTracker, cleanDeviceConfig, createPlatformLogger, formatDeviceIdAsMac, hs2rgb, makeBLESender, makeOpenAPISender, rgb2hs, sleep } from './utils.js';
 export class SwitchBotMatterPlatform {
     log;
     config;
@@ -21,6 +21,12 @@ export class SwitchBotMatterPlatform {
     accessoryInstances = new Map();
     // Refresh timers keyed by normalized deviceId
     refreshTimers = new Map();
+    // Platform-level refresh timer for batch status updates
+    platformRefreshTimer;
+    // Device status cache from last refresh
+    deviceStatusCache = new Map();
+    // Devices that have explicit per-device refresh timers (normalized deviceId)
+    perDeviceRefreshSet = new Set();
     // BLE event handlers keyed by device MAC (formatted)
     bleEventHandler = {};
     // MQTT and Webhook properties (mirror HAP behavior so Matter platform can
@@ -31,6 +37,8 @@ export class SwitchBotMatterPlatform {
     // Platform logging toggle (can be controlled via UI or config)
     // Use same shape as HAP platform: string values like 'debug', 'debugMode', 'standard', or 'none'
     platformLogging;
+    // API request tracking (persistent across restarts)
+    apiTracker;
     // Platform-provided logging helpers (attached in constructor)
     infoLog;
     successLog;
@@ -132,6 +140,14 @@ export class SwitchBotMatterPlatform {
             catch (e) {
                 this.errorLog('Failed to initialize SwitchBot OpenAPI:', e?.message ?? e);
             }
+            // Initialize API request tracking
+            try {
+                this.apiTracker = new ApiRequestTracker(this.api, this.log, 'SwitchBot Matter');
+                this.apiTracker.startHourlyLogging();
+            }
+            catch (e) {
+                this.errorLog('Failed to initialize API request tracking:', e?.message ?? e);
+            }
             try {
                 this.switchBotBLE = new SwitchBotBLE();
                 if (!this.config.options?.disableLogsforBLE && this.switchBotBLE?.on) {
@@ -170,6 +186,10 @@ export class SwitchBotMatterPlatform {
             this.api.on('shutdown', async () => {
                 try {
                     this.infoLog('Homebridge shutting down: clearing refresh timers and BLE handlers');
+                    // Stop API tracking hourly logging
+                    if (this.apiTracker) {
+                        this.apiTracker.stopHourlyLogging();
+                    }
                     // Clear all refresh timers
                     for (const [nid, t] of Array.from(this.refreshTimers.entries())) {
                         try {
@@ -180,6 +200,16 @@ export class SwitchBotMatterPlatform {
                         }
                         this.refreshTimers.delete(nid);
                     }
+                    // Clear platform-level refresh timer
+                    try {
+                        if (this.platformRefreshTimer) {
+                            clearInterval(this.platformRefreshTimer);
+                            this.platformRefreshTimer = undefined;
+                        }
+                    }
+                    catch (e) {
+                        this.debugLog(`Failed to clear platform refresh timer: ${e?.message ?? e}`);
+                    }
                     // Clear accessory instances registry
                     try {
                         this.accessoryInstances.clear();
@@ -245,6 +275,13 @@ export class SwitchBotMatterPlatform {
     normalizeDeviceId(deviceId) {
         return (deviceId ?? '').toUpperCase().replace(/[^A-Z0-9]+/g, '');
     }
+    /** Determine the platform-level batch interval in seconds */
+    getPlatformBatchInterval() {
+        const opt = this.config.options;
+        const val = opt?.matterBatchRefreshRate ?? opt?.refreshRate ?? 300;
+        const n = Number(val);
+        return Number.isFinite(n) && n > 0 ? n : 300;
+    }
     /**
      * Clear per-device resources: refresh timers, accessory instance registry, BLE handlers
      */
@@ -661,40 +698,55 @@ export class SwitchBotMatterPlatform {
                         }
                         // Brightness
                         if (parsed.brightness !== undefined) {
-                            const level = Math.round((Number(parsed.brightness) / 100) * 254);
+                            const rawLevel = Math.round((Number(parsed.brightness) / 100) * 254);
+                            const level = Math.max(0, Math.min(254, rawLevel));
+                            this.debugLog(`[BLE Brightness Debug] Device ${dev.deviceId}: rawBrightness=${parsed.brightness}, calculated=${rawLevel}, clamped=${level}`);
                             await this.api.matter.updateAccessoryState(uuidLocal, this.api.matter.clusterNames.LevelControl, { currentLevel: level });
                         }
                         // Color
                         if (parsed.color !== undefined) {
                             const { r, g, b } = parsed.color;
                             const [h, s] = rgb2hs(r, g, b);
-                            await this.api.matter.updateAccessoryState(uuidLocal, this.api.matter.clusterNames.ColorControl, { currentHue: Math.round((h / 360) * 254), currentSaturation: Math.round((s / 100) * 254) });
+                            const rawHue = Math.round((h / 360) * 254);
+                            const rawSat = Math.round((s / 100) * 254);
+                            const hue = Math.max(0, Math.min(254, rawHue));
+                            const sat = Math.max(0, Math.min(254, rawSat));
+                            this.debugLog(`[BLE Color Debug] Device ${dev.deviceId}: RGB=[${r},${g},${b}], HS=[${h},${s}], Matter=[${rawHue},${rawSat}], clamped=[${hue},${sat}]`);
+                            await this.api.matter.updateAccessoryState(uuidLocal, this.api.matter.clusterNames.ColorControl, { currentHue: hue, currentSaturation: sat });
                         }
                         // Battery -> powerSource cluster (common mapping)
                         if (parsed.battery !== undefined) {
-                            try {
-                                const percentage = Number(parsed.battery);
-                                const batPercentRemaining = Math.max(0, Math.min(200, Math.round(percentage * 2)));
-                                let batChargeLevel = 0;
-                                if (percentage < 20) {
-                                    batChargeLevel = 2;
-                                }
-                                else if (percentage < 40) {
-                                    batChargeLevel = 1;
-                                }
+                            // Skip battery updates for device types that don't support PowerSource cluster
+                            const deviceType = String(dev?.deviceType ?? '');
+                            const unsupportedTypes = ['Curtain', 'Curtain2', 'Curtain3', 'Curtain 2', 'Blind Tilt'];
+                            if (unsupportedTypes.includes(deviceType)) {
+                                this.debugLog(`Device ${dev.deviceId} type ${deviceType} does not support PowerSource cluster, skipping BLE battery update`);
+                            }
+                            else {
                                 try {
-                                    await this.api.matter.updateAccessoryState(uuidLocal, 'powerSource', { batPercentRemaining, batChargeLevel });
-                                }
-                                catch (updateError) {
-                                    // Silently skip if powerSource cluster doesn't exist on this device
-                                    const msg = String(updateError?.message ?? updateError);
-                                    if (!msg.includes('does not exist') && !msg.includes('not found')) {
-                                        throw updateError;
+                                    const percentage = Number(parsed.battery);
+                                    const batPercentRemaining = Math.max(0, Math.min(200, Math.round(percentage * 2)));
+                                    let batChargeLevel = 0;
+                                    if (percentage < 20) {
+                                        batChargeLevel = 2;
+                                    }
+                                    else if (percentage < 40) {
+                                        batChargeLevel = 1;
+                                    }
+                                    try {
+                                        await this.api.matter.updateAccessoryState(uuidLocal, 'powerSource', { batPercentRemaining, batChargeLevel });
+                                    }
+                                    catch (updateError) {
+                                        // Silently skip if powerSource cluster doesn't exist on this device
+                                        const msg = String(updateError?.message ?? updateError);
+                                        if (!msg.includes('does not exist') && !msg.includes('not found')) {
+                                            throw updateError;
+                                        }
                                     }
                                 }
-                            }
-                            catch (e) {
-                                this.debugLog(`Failed to update battery state for ${dev.deviceId}: ${e?.message ?? e}`);
+                                catch (e) {
+                                    this.debugLog(`Failed to update battery state for ${dev.deviceId}: ${e?.message ?? e}`);
+                                }
                             }
                         }
                         // Temperature -> temperatureMeasurement
@@ -821,6 +873,7 @@ export class SwitchBotMatterPlatform {
                     return;
                 }
                 try {
+                    this.apiTracker?.track();
                     const { response, statusCode } = await this.switchBotAPI.getDeviceStatus(dev.deviceId, this.config.credentials?.token, this.config.credentials?.secret);
                     const respAny = response;
                     const body = respAny?.body ?? respAny;
@@ -855,13 +908,15 @@ export class SwitchBotMatterPlatform {
                 clearInterval(existing);
                 this.refreshTimers.delete(nid);
             }
-            const refreshRateSec = dev.refreshRate ?? this.config.options?.refreshRate ?? 300;
-            if (this.switchBotAPI && refreshRateSec && Number(refreshRateSec) > 0) {
+            const platformInterval = this.getPlatformBatchInterval();
+            const hasDeviceInterval = typeof dev.refreshRate === 'number' && Number(dev.refreshRate) > 0;
+            if (this.switchBotAPI && (hasDeviceInterval || platformInterval > 0)) {
                 // Immediate one-shot to populate initial state
                 ;
                 (async () => {
                     try {
                         this.infoLog(`Performing initial OpenAPI refresh for ${dev.deviceId}`);
+                        this.apiTracker?.track();
                         const { response, statusCode } = await this.switchBotAPI.getDeviceStatus(dev.deviceId, this.config.credentials?.token, this.config.credentials?.secret);
                         const respAny = response;
                         const body = respAny?.body ?? respAny;
@@ -885,32 +940,25 @@ export class SwitchBotMatterPlatform {
                         this.errorLog(`Initial OpenAPI refresh failed for ${dev.deviceId}: ${e?.message ?? e}`);
                     }
                 })();
-                const timer = setInterval(async () => {
-                    try {
-                        this.debugLog(`Performing periodic OpenAPI refresh for ${dev.deviceId}`);
-                        const { response, statusCode } = await this.switchBotAPI.getDeviceStatus(dev.deviceId, this.config.credentials?.token, this.config.credentials?.secret);
-                        const respAny = response;
-                        const body = respAny?.body ?? respAny;
+                if (hasDeviceInterval) {
+                    // Create a per-device timer and exclude it from batch
+                    const interval = Number(dev.refreshRate);
+                    this.perDeviceRefreshSet.add(nid);
+                    const timer = setInterval(async () => {
                         try {
-                            const s = JSON.stringify(body);
-                            this.debugLog(`Periodic OpenAPI refresh for ${dev.deviceId} returned statusCode=${statusCode} body=${s}`);
+                            await this.refreshSingleDeviceWithRetry(dev);
                         }
                         catch (e) {
-                            this.debugLog(`Periodic OpenAPI refresh for ${dev.deviceId} returned statusCode=${statusCode} (body not stringifiable)`);
-                        }
-                        if (statusCode === 100 || statusCode === 200) {
-                            const status = body?.status ?? body;
-                            await this.applyStatusToAccessory(uuid, dev, status);
-                        }
-                        else {
-                            this.debugLog(`Periodic OpenAPI refresh returned unexpected statusCode=${statusCode} for ${dev.deviceId}`);
+                            this.debugLog(`Per-device refresh failed for ${dev.deviceId}: ${e?.message ?? e}`);
                         }
-                    }
-                    catch (e) {
-                        this.errorLog(`Periodic OpenAPI refresh failed for ${dev.deviceId}: ${e?.message ?? e}`);
-                    }
-                }, Number(refreshRateSec) * 1000);
-                this.refreshTimers.set(nid, timer);
+                    }, interval * 1000);
+                    this.refreshTimers.set(nid, timer);
+                    this.infoLog(`Started per-device refresh timer for ${dev.deviceId} at ${interval}s`);
+                }
+                else {
+                    // Start platform-level batched refresh timer (only once)
+                    this.startPlatformRefreshTimer(platformInterval);
+                }
             }
         }
         catch (e) {
@@ -927,6 +975,7 @@ export class SwitchBotMatterPlatform {
             return;
         }
         try {
+            this.apiTracker?.track();
             const { response, statusCode } = await this.switchBotAPI.getDevices();
             this.debugLog(`SwitchBot getDevices response status: ${statusCode}`);
             if (statusCode === 100 || statusCode === 200) {
@@ -1029,6 +1078,7 @@ export class SwitchBotMatterPlatform {
                 if (!this.switchBotAPI) {
                     throw new Error('SwitchBot OpenAPI not initialized');
                 }
+                this.apiTracker?.track();
                 const { response, statusCode } = await this.switchBotAPI.controlDevice(deviceObj.deviceId, bodyChange.command, bodyChange.parameter, bodyChange.commandType, this.config.credentials?.token, this.config.credentials?.secret);
                 return { response, statusCode };
             }
@@ -1258,10 +1308,19 @@ export class SwitchBotMatterPlatform {
             // Brightness
             if (status?.brightness !== undefined) {
                 const rawBrightness = Number(status.brightness);
-                const level = Math.round((rawBrightness / 100) * 254);
-                const clampedLevel = Math.max(0, Math.min(254, level));
-                this.debugLog(`[Brightness Debug] Device ${dev.deviceId}: rawBrightness=${rawBrightness}, calculated=${level}, clamped=${clampedLevel}`);
-                await safeUpdate(this.api.matter.clusterNames.LevelControl, { currentLevel: clampedLevel }, 'updateBrightness');
+                const clampedBrightness = Math.max(0, Math.min(100, rawBrightness));
+                // If instance has updateBrightness method, it expects percentage (0-100)
+                // Otherwise, updateAccessoryState expects Matter-scaled value (0-254)
+                if (instance && typeof instance.updateBrightness === 'function') {
+                    this.debugLog(`[Brightness Debug] Device ${dev.deviceId}: calling updateBrightness with percent=${clampedBrightness}`);
+                    await safeUpdate(this.api.matter.clusterNames.LevelControl, { currentLevel: clampedBrightness }, 'updateBrightness');
+                }
+                else {
+                    const level = Math.round((clampedBrightness / 100) * 254);
+                    const clampedLevel = Math.max(0, Math.min(254, level));
+                    this.debugLog(`[Brightness Debug] Device ${dev.deviceId}: calling updateAccessoryState with rawBrightness=${rawBrightness}, level=${clampedLevel}`);
+                    await safeUpdate(this.api.matter.clusterNames.LevelControl, { currentLevel: clampedLevel });
+                }
             }
             // Color
             if (status?.color !== undefined) {
@@ -1288,30 +1347,49 @@ export class SwitchBotMatterPlatform {
                     b = Number.parseInt(hex.substring(4, 6), 16);
                 }
                 const [h, s] = rgb2hs(r, g, b);
-                const hue = Math.round((h / 360) * 254);
-                const sat = Math.round((s / 100) * 254);
-                const clampedHue = Math.max(0, Math.min(254, hue));
-                const clampedSat = Math.max(0, Math.min(254, sat));
-                this.debugLog(`[Color Debug] Device ${dev.deviceId}: color="${color}", RGB=[${r},${g},${b}], HS=[${h},${s}], Matter=[${hue},${sat}], clamped=[${clampedHue},${clampedSat}]`);
-                await safeUpdate(this.api.matter.clusterNames.ColorControl, { currentHue: clampedHue, currentSaturation: clampedSat }, 'updateHueSaturation');
+                const clampedH = Math.max(0, Math.min(360, h));
+                const clampedS = Math.max(0, Math.min(100, s));
+                // If instance has updateHueSaturation method, it expects raw values (h: 0-360, s: 0-100)
+                // Otherwise, updateAccessoryState expects Matter-scaled values (0-254)
+                if (instance && typeof instance.updateHueSaturation === 'function') {
+                    this.debugLog(`[Color Debug] Device ${dev.deviceId}: calling updateHueSaturation with color="${color}", RGB=[${r},${g},${b}], HS=[${clampedH},${clampedS}]`);
+                    await safeUpdate(this.api.matter.clusterNames.ColorControl, { currentHue: clampedH, currentSaturation: clampedS }, 'updateHueSaturation');
+                }
+                else {
+                    const hue = Math.round((clampedH / 360) * 254);
+                    const sat = Math.round((clampedS / 100) * 254);
+                    const clampedHue = Math.max(0, Math.min(254, hue));
+                    const clampedSat = Math.max(0, Math.min(254, sat));
+                    this.debugLog(`[Color Debug] Device ${dev.deviceId}: calling updateAccessoryState with color="${color}", RGB=[${r},${g},${b}], HS=[${h},${s}], Matter=[${clampedHue},${clampedSat}]`);
+                    await safeUpdate(this.api.matter.clusterNames.ColorControl, { currentHue: clampedHue, currentSaturation: clampedSat });
+                }
             }
             // Battery/powerSource (support many possible field names)
+            // Note: Some device types like WindowBlind don't support PowerSource cluster
             if (status?.battery !== undefined || status?.batt !== undefined || status?.batteryLevel !== undefined || status?.batteryPercentage !== undefined || status?.battery_level !== undefined) {
-                try {
-                    const percentage = Number(status?.battery ?? status?.batt ?? status?.batteryPercentage ?? status?.batteryLevel ?? status?.battery_level);
-                    const batPercentRemaining = Math.max(0, Math.min(200, Math.round(percentage * 2)));
-                    let batChargeLevel = 0;
-                    if (percentage < 20) {
-                        batChargeLevel = 2;
+                // Skip battery updates for device types that don't support PowerSource cluster
+                const deviceType = String(status?.deviceType ?? dev?.deviceType ?? '');
+                const unsupportedTypes = ['Curtain', 'Curtain2', 'Curtain3', 'Curtain 2', 'Blind Tilt'];
+                if (unsupportedTypes.includes(deviceType)) {
+                    this.debugLog(`Device ${dev.deviceId} type ${deviceType} does not support PowerSource cluster, skipping battery update`);
+                }
+                else {
+                    try {
+                        const percentage = Number(status?.battery ?? status?.batt ?? status?.batteryPercentage ?? status?.batteryLevel ?? status?.battery_level);
+                        const batPercentRemaining = Math.max(0, Math.min(200, Math.round(percentage * 2)));
+                        let batChargeLevel = 0;
+                        if (percentage < 20) {
+                            batChargeLevel = 2;
+                        }
+                        else if (percentage < 40) {
+                            batChargeLevel = 1;
+                        }
+                        const powerCluster = (this.api.matter?.clusterNames && this.api.matter.clusterNames.PowerSource) ? this.api.matter.clusterNames.PowerSource : 'powerSource';
+                        await safeUpdate(powerCluster, { batPercentRemaining, batChargeLevel }, 'updateBatteryPercentage');
                     }
-                    else if (percentage < 40) {
-                        batChargeLevel = 1;
+                    catch (e) {
+                        this.debugLog(`Failed to apply battery status for ${dev.deviceId}: ${e?.message ?? e}`);
                     }
-                    const powerCluster = (this.api.matter?.clusterNames && this.api.matter.clusterNames.PowerSource) ? this.api.matter.clusterNames.PowerSource : 'powerSource';
-                    await safeUpdate(powerCluster, { batPercentRemaining, batChargeLevel }, 'updateBatteryPercentage');
-                }
-                catch (e) {
-                    this.debugLog(`Failed to apply battery status for ${dev.deviceId}: ${e?.message ?? e}`);
                 }
             }
             // Temperature + thermostat
@@ -1923,5 +2001,112 @@ export class SwitchBotMatterPlatform {
             await this.api.matter.registerPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, accessories);
         }
     }
+    /**
+     * Start platform-level refresh timer to batch all device status updates
+     */
+    startPlatformRefreshTimer(refreshRateSec) {
+        // Only create timer once
+        if (this.platformRefreshTimer) {
+            return;
+        }
+        this.debugLog(`Starting platform-level refresh timer with interval ${refreshRateSec}s`);
+        this.platformRefreshTimer = setInterval(async () => {
+            await this.batchRefreshAllDevices();
+        }, Number(refreshRateSec) * 1000);
+    }
+    /**
+     * 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
+     */
+    async batchRefreshAllDevices() {
+        if (!this.switchBotAPI) {
+            return;
+        }
+        this.debugLog('Performing batched periodic OpenAPI refresh for all devices');
+        // Build list from registered accessory instances (uuid) and discovered devices
+        const devicesToRefresh = [];
+        try {
+            for (const [nid, instance] of this.accessoryInstances.entries()) {
+                const uuid = instance?.uuid;
+                if (!uuid) {
+                    continue;
+                }
+                const dev = this.discoveredDevices.find(d => this.normalizeDeviceId(d.deviceId) === nid);
+                if (dev && !this.perDeviceRefreshSet.has(nid)) {
+                    devicesToRefresh.push({ uuid, dev });
+                }
+            }
+        }
+        catch (e) {
+            this.errorLog(`Failed to enumerate devices for batch refresh: ${e?.message ?? e}`);
+            return;
+        }
+        if (devicesToRefresh.length === 0) {
+            this.debugLog('No devices to refresh');
+            return;
+        }
+        this.debugLog(`Refreshing ${devicesToRefresh.length} devices in parallel batch`);
+        const concurrency = Number(this.config.options?.matterBatchConcurrency ?? 5);
+        await this.runWithConcurrency(devicesToRefresh, async ({ uuid, dev }) => {
+            try {
+                const status = await this.refreshSingleDeviceWithRetry(dev);
+                if (status) {
+                    await this.applyStatusToAccessory(uuid, dev, status);
+                }
+            }
+            catch (e) {
+                this.errorLog(`Periodic OpenAPI refresh failed for ${dev.deviceId}: ${e?.message ?? e}`);
+            }
+        }, Number.isFinite(concurrency) && concurrency > 0 ? concurrency : 5);
+        this.debugLog(`Batch refresh completed for ${devicesToRefresh.length} devices`);
+    }
+    /** Refresh a single device with retry and backoff; returns status object if successful */
+    async refreshSingleDeviceWithRetry(dev, retries = 3, baseDelayMs = 500) {
+        const deviceId = dev.deviceId;
+        let attempt = 0;
+        while (attempt <= retries) {
+            try {
+                this.apiTracker?.track();
+                const { response, statusCode } = await this.switchBotAPI.getDeviceStatus(deviceId, this.config.credentials?.token, this.config.credentials?.secret);
+                const respAny = response;
+                const body = respAny?.body ?? respAny;
+                if (statusCode === 100 || statusCode === 200) {
+                    const status = body?.status ?? body;
+                    this.deviceStatusCache.set(this.normalizeDeviceId(deviceId), { status, timestamp: Date.now() });
+                    this.debugLog(`OpenAPI refresh succeeded for ${deviceId} (attempt ${attempt + 1})`);
+                    return status;
+                }
+                this.debugLog(`OpenAPI refresh unexpected statusCode=${statusCode} for ${deviceId} (attempt ${attempt + 1})`);
+            }
+            catch (e) {
+                this.debugLog(`OpenAPI refresh error for ${deviceId} (attempt ${attempt + 1}): ${e?.message ?? e}`);
+            }
+            // backoff before next retry if any left
+            attempt++;
+            if (attempt <= retries) {
+                const delay = baseDelayMs * (2 ** (attempt - 1));
+                await sleep(delay);
+            }
+        }
+        return null;
+    }
+    /** Simple concurrency limiter for an array of items */
+    async runWithConcurrency(items, worker, concurrency) {
+        const queue = items.slice();
+        const workers = [];
+        const runNext = async () => {
+            const item = queue.shift();
+            if (!item) {
+                return;
+            }
+            await worker(item);
+            return runNext();
+        };
+        const pool = Math.min(concurrency, Math.max(1, items.length));
+        for (let i = 0; i < pool; i++) {
+            workers.push(runNext());
+        }
+        await Promise.all(workers);
+    }
 }
 //# sourceMappingURL=platform-matter.js.map