@homebridge-plugins/homebridge-sharkiq 2.0.0-beta.3 → 2.0.0-beta.31

package/CHANGELOG.md

@@ -2,11 +2,27 @@
 
 All notable changes to this project will be documented in this file. This project uses [Semantic Versioning](https://semver.org/)
 
-## [1.4.1] (TBD)
+## [2.0.0] (https://github.com/homebridge-plugins/homebridge-sharkiq/releases/tag/v2.0.0) (2025-XX-XX)
+
+### Breaking Changes
+- This release is Matter-only. The plugin now publishes external Matter Robotic Vacuum Cleaner accessories and no longer publishes HAP platform accessories. If you need the legacy HAP behavior, continue using a pre-2.0 release or a branch that preserves the HAP path.
+- Minimum required Homebridge: >= 2.0.0-alpha.28 (or later) with Matter support exposed via `api.matter`.
+
+### What's Changed
+- Converted plugin to Matter-only and added Matter external accessory publishing for Robotic Vacuum Cleaner devices.
+- Added lifecycle wiring so accessories wait for READY before initial sync and polling.
+- Added retry/backoff for critical Ayla API calls.
+- Removed HAP-specific configuration options (invertDockedStatus, dockedUpdateInterval, enhancedVacuumMode).
+
+**Full Changelog**: https://github.com/homebridge-plugins/homebridge-sharkiq/compare/v1.4.1...v2.0.0
+
+## [1.4.1] (https://github.com/homebridge-plugins/homebridge-sharkiq/releases/tag/v1.4.1) (2025-XX-XX)
 
 ### What's Changed
 - Fix ARM64 OAuth code handling for users with both email/password and OAuth code [#54](https://github.com/homebridge-plugins/homebridge-sharkiq/issues/54)
 
+**Full Changelog**: https://github.com/homebridge-plugins/homebridge-sharkiq/compare/v1.4.0...v1.4.1
+
 ## [1.4.0](https://github.com/homebridge-plugins/homebridge-sharkiq/releases/tag/v1.4.0) (2025-07-17)
 
 ### What's Changes
@@ -14,4 +30,5 @@ All notable changes to this project will be documented in this file. This projec
 - Fix JSON parsing errors in SharkIQ API responses [#44](https://github.com/homebridge-plugins/homebridge-sharkiq/pull/44) [@mmenanno](https://github.com/mmenanno)
 - Housekeeping and updated dependencies.
 
-**Full Changelog**: https://github.com/homebridge-plugins/homebridge-sharkiq/compare/v1.3.2...v1.4.0
+**Full Changelog**: https://github.com/homebridge-plugins/homebridge-sharkiq/compare/v1.3.2...v1.4.0
+

package/README.md

@@ -39,10 +39,7 @@ Configure Homebridge. The config file for SharkIQ should include:
         "[Shark Vacuum DSN]",
         "..."
       ],
-      "europe": false,
-      "invertDockedStatus": false,
-      "dockedUpdateInterval": 30000,
-      "enhancedVacuumMode": true
+      "europe": false
     }
   ]
 }
@@ -78,6 +75,15 @@ The `enhancedVacuumMode` option (enabled by default) provides improved vacuum be
 
 ## Homebridge 2.0.0+ Compatibility
 
+This release of the plugin is Matter-only and requires a Homebridge runtime that exposes the Matter API.
+Minimum tested Homebridge: 2.0.0-alpha.28 or later. If your Homebridge installation does not support Matter, this plugin will log an error and will not start.
+
+This plugin uses Matter external accessories (Robotic Vacuum Cleaner) to integrate with the platform and no longer publishes HAP platform accessories.
+
+If you rely on the legacy HAP (HomeKit) path, keep using an older plugin release or run this code from a separate branch — this release intentionally removes HAP fallback.
+
+Compatibility notes and behavior:
+
 This plugin is compatible with Homebridge 2.0.0-alpha.28 and later versions, providing enhanced vacuum functionality while maintaining compatibility with current HomeKit limitations:
 
 - **Current Implementation**: Uses optimized FanV2 service with vacuum-specific behavior
@@ -109,3 +115,34 @@ Contributions would be very helpful to help this Homebridge plugin stay maintain
 ## Useful Links
 
 - [SharkIQ Python](https://github.com/JeffResc/sharkiq/)
+
+## Integration checklist — Matter
+
+Follow these steps to verify Matter integration locally on a Homebridge instance that supports Matter (Homebridge >= 2.0.0-alpha.28):
+
+1. Ensure your Homebridge runtime supports Matter and the `api.matter` external accessory API.
+2. Configure the plugin in `config.json` with your Shark credentials or `oAuthCode` and do NOT include deprecated HAP-only options (the plugin is Matter-only).
+3. Start Homebridge in a terminal and watch logs. You should see the plugin log the DSNs found on your account and then a "Publishing X robotic device(s) as external Matter accessories" message.
+4. After publishing, Homebridge should emit READY/COMMISSIONED events for each accessory. The plugin will perform an initial sync and start polling.
+5. From the Home app or a Matter controller, attempt these actions and verify the vacuum responds:
+
+- Start / Stop cleaning
+- Pause / Resume
+- Go Home (return to dock)
+- Select Areas (if your device supports area cleaning)
+
+6. Observe plugin logs for successful API calls and state updates. Look for `Matter accessory ready` and `Performing initial device sync` log lines.
+
+Quick troubleshooting:
+
+- If you see "requires Homebridge with Matter support" in logs, update Homebridge to a Matter-enabled build.
+- If actions fail, inspect network connectivity and plugin logs for Ayla API errors; the plugin now includes retries with exponential backoff for critical calls.
+
+Optional: run the prepublish checks locally (lint, build, docs) to validate everything before publishing:
+
+```bash
+# Run this in the project root (macOS / zsh)
+npm run prepublishOnly
+```
+
+If you'd like, I can add a short automated script that validates a sample run (requires a Matter-enabled Homebridge instance and credentials).

package/config.schema.json

@@ -30,7 +30,7 @@
       "vacuums": {
         "title": "SharkClean Vacuum Devicess",
         "type": "array",
-        "required": true,
+        "required": false,
         "items": {
           "title": "SharkClean DSN",
           "type": "string"
@@ -43,25 +43,14 @@
         "required": false,
         "default": false
       },
-      "invertDockedStatus": {
-        "title": "Invert Vacuum Docked Status",
-        "type": "boolean",
-        "required": false,
-        "default": false
-      },
-      "dockedUpdateInterval": {
-        "title": "Docked Update Interval",
-        "type": "integer",
+      "pollInterval": {
+        "title": "Polling interval (seconds)",
+        "description": "How often to poll Shark devices for status updates. Set to 0 to disable polling.",
+        "type": "number",
         "required": false,
-        "default": 30000
-      },
-      "enhancedVacuumMode": {
-        "title": "Enhanced Vacuum Mode",
-        "type": "boolean",
-        "required": false,
-        "default": true,
-        "description": "Use improved power level mappings and vacuum-optimized behavior. Prepares for future robot vacuum service support."
+        "default": 30
       }
+
     }
   },
   "layout": [
@@ -113,14 +102,7 @@
             }
           ]
         },
-        "europe",
-        "invertDockedStatus",
-        "dockedUpdateInterval",
-        {
-          "type": "help",
-          "helpvalue": "<h5>Enhanced Vacuum Mode</h5><em class='primary-text'>Enables improved vacuum behavior with better power level mappings (25%=Eco, 50%=Normal, 100%=Max). This prepares your setup for future native HomeKit robot vacuum support.</em>"
-        },
-        "enhancedVacuumMode"
+        "europe"
       ]
     }
   ]

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AAEX,eAAO,MAAM,QAAQ;;;;;;CAMX,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,aAAa;;;;;CAKhB,CAAA;AAEV,eAAO,MAAM,QAAQ;;;;;;CAMX,CAAA"}

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,EAAE;IACP,MAAM,EAAE,EAAE;IACV,GAAG,EAAE,EAAE;CACC,CAAC;AAEX,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,WAAW,EAAE,IAAI;IACjB,aAAa,EAAE,IAAI;IACnB,mBAAmB,EAAE,GAAG;IACxB,8BAA8B,EAAE,IAAI;IACpC,uBAAuB,EAAE,GAAG;CACpB,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,EAAE;IACP,MAAM,EAAE,EAAE;IACV,GAAG,EAAE,EAAE;CACC,CAAA;AAEV,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,WAAW,EAAE,IAAI;IACjB,aAAa,EAAE,IAAI;IACnB,mBAAmB,EAAE,GAAG;IACxB,8BAA8B,EAAE,IAAI;IACpC,uBAAuB,EAAE,GAAG;CACpB,CAAA"}

package/dist/devices/BaseMatterAccessory.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Base Matter Accessory Class
+ *
+ * This base class implements the MatterAccessory interface and provides
+ * common functionality that all Matter devices can use.
+ *
+ * Individual device types should extend this class and call super() with
+ * the required configuration.
+ */
+import type { API, EndpointType, Logger, MatterAccessory } from 'homebridge';
+export interface BaseMatterAccessoryConfig {
+    uuid: string;
+    displayName: string;
+    deviceType: EndpointType;
+    serialNumber: string;
+    manufacturer: string;
+    model: string;
+    firmwareRevision: string;
+    hardwareRevision: string;
+    context?: Record<string, unknown>;
+    clusters?: MatterAccessory['clusters'];
+    handlers?: MatterAccessory['handlers'];
+    parts?: MatterAccessory['parts'];
+    /** Optional mapping from legacy cluster names to supported cluster names. */
+    clusterNameMap?: Record<string, string>;
+    /** Enable translation behavior for legacy clusters like 'power' and 'diagnostics'. */
+    translateLegacyClusters?: boolean;
+}
+/**
+ * Base class for all Matter accessories
+ * Implements the MatterAccessory interface and provides common methods
+ */
+export declare abstract class BaseMatterAccessory implements MatterAccessory {
+    /** In-memory cache for battery/charging state to suppress noisy logs */
+    protected lastBatteryLevel: number | null;
+    protected lastChargingStatus: boolean | null;
+    readonly uuid: string;
+    readonly displayName: string;
+    readonly deviceType: EndpointType;
+    readonly serialNumber: string;
+    readonly manufacturer: string;
+    readonly model: string;
+    readonly firmwareRevision: string;
+    readonly hardwareRevision: string;
+    readonly context: Record<string, unknown>;
+    readonly clusters?: MatterAccessory['clusters'];
+    readonly handlers?: MatterAccessory['handlers'];
+    readonly parts?: MatterAccessory['parts'];
+    /** Optional mapping table for legacy cluster names */
+    readonly clusterNameMap?: Record<string, string>;
+    /** Whether to translate legacy clusters (can be toggled at runtime via context.translateLegacyClusters) */
+    protected readonly translateLegacyClusters: boolean;
+    protected readonly api: API;
+    protected readonly log: Logger;
+    constructor(api: API, log: Logger, config: BaseMatterAccessoryConfig);
+    /**
+     * Update the accessory state
+     * Helper method to update cluster attributes
+     */
+    protected updateState(cluster: string, attributes: Record<string, unknown>): Promise<void>;
+    /**
+     * Log helper methods
+     */
+    protected logInfo(message: string, ...args: unknown[]): void;
+    protected logError(message: string, ...args: unknown[]): void;
+    protected logDebug(message: string, ...args: unknown[]): void;
+    protected logWarn(message: string, ...args: unknown[]): void;
+    /**
+     * Convert this class instance to a plain MatterAccessory object
+     * This is what gets registered with Homebridge
+     */
+    toAccessory(): MatterAccessory;
+}
+//# sourceMappingURL=BaseMatterAccessory.d.ts.map

package/dist/devices/BaseMatterAccessory.d.ts.map

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

package/dist/devices/BaseMatterAccessory.js

@@ -0,0 +1,210 @@
+/**
+ * Base Matter Accessory Class
+ *
+ * This base class implements the MatterAccessory interface and provides
+ * common functionality that all Matter devices can use.
+ *
+ * Individual device types should extend this class and call super() with
+ * the required configuration.
+ */
+/**
+ * Base class for all Matter accessories
+ * Implements the MatterAccessory interface and provides common methods
+ */
+export class BaseMatterAccessory {
+    /** In-memory cache for battery/charging state to suppress noisy logs */
+    lastBatteryLevel = null;
+    lastChargingStatus = null;
+    // Required MatterAccessory properties
+    uuid;
+    displayName;
+    deviceType;
+    serialNumber;
+    manufacturer;
+    model;
+    firmwareRevision;
+    hardwareRevision;
+    context;
+    clusters;
+    handlers;
+    parts;
+    /** Optional mapping table for legacy cluster names */
+    clusterNameMap;
+    /** Whether to translate legacy clusters (can be toggled at runtime via context.translateLegacyClusters) */
+    translateLegacyClusters;
+    // Protected properties available to child classes
+    api;
+    log;
+    constructor(api, log, config) {
+        this.api = api;
+        this.log = log;
+        // Set all required properties
+        this.uuid = config.uuid;
+        this.displayName = config.displayName;
+        this.deviceType = config.deviceType;
+        this.serialNumber = config.serialNumber;
+        this.manufacturer = config.manufacturer;
+        this.model = config.model;
+        this.firmwareRevision = config.firmwareRevision;
+        this.hardwareRevision = config.hardwareRevision;
+        this.clusters = config.clusters;
+        this.handlers = config.handlers;
+        this.parts = config.parts;
+        this.clusterNameMap = config.clusterNameMap || {};
+        this.translateLegacyClusters = typeof config.translateLegacyClusters === 'boolean' ? config.translateLegacyClusters : true;
+        // Set context with all metadata
+        this.context = {
+            serialNumber: this.serialNumber,
+            manufacturer: this.manufacturer,
+            model: this.model,
+            firmwareRevision: this.firmwareRevision,
+            hardwareRevision: this.hardwareRevision,
+            ...config.context,
+        };
+    }
+    /**
+     * Update the accessory state
+     * Helper method to update cluster attributes
+     */
+    async updateState(cluster, attributes) {
+        // First, allow a configured mapping from legacy cluster names to the
+        // clusters we actually registered. This supports older code paths that
+        // attempted to update clusters like 'power' or 'diagnostics'. The mapping
+        // is optional and can be provided per-accessory via config.
+        const mapped = (this.clusterNameMap && this.clusterNameMap[cluster]) || cluster;
+        // If the mapped cluster exists on this accessory and this is not a
+        // legacy cluster that requires translation, forward the update.
+        const isLegacy = cluster === 'power' || cluster === 'diagnostics';
+        if (this.clusters && (mapped in this.clusters) && !isLegacy) {
+            try {
+                await this.api.matter.updateAccessoryState(this.uuid, mapped, attributes);
+                this.log.debug(`[${this.displayName}] Updated ${mapped} state (from ${cluster}):`, attributes);
+            }
+            catch (e) {
+                // Matter may report the accessory as not registered when running
+                // in Child/Bridge configurations; surface as debug to avoid
+                // noisy stack traces while still recording the failure.
+                this.logDebug(`Failed to update ${mapped} state (from ${cluster}): ${e?.message || e}`);
+            }
+            return;
+        }
+        // Special-case handling for legacy clusters when no direct mapping exists.
+        // These translate a small set of commonly-updated attributes into updates
+        // against supported clusters (for vacuum devices we commonly support
+        // 'rvcOperationalState'). This avoids noisy "Behavior ID ... does not
+        // exist" errors while preserving useful state updates.
+        // Determine whether translations are enabled for this accessory at runtime.
+        const runtimeTranslate = typeof this.context.translateLegacyClusters === 'boolean'
+            ? this.context.translateLegacyClusters
+            : this.translateLegacyClusters;
+        if (cluster === 'power') {
+            // batteryLevel and charging are informational. If charging is present
+            // and we have rvcOperationalState, translate charging->Charging(65)
+            // or not-charging->Docked(66). Also log battery percentage locally.
+            const batteryLevel = attributes.batteryLevel;
+            const charging = attributes.charging;
+            if (typeof batteryLevel === 'number') {
+                // Use in-memory cache to suppress noisy logs
+                const chargingBool = typeof charging === 'boolean' ? charging : (charging === 1);
+                const batteryChanged = this.lastBatteryLevel === null || this.lastBatteryLevel !== batteryLevel;
+                const chargingChanged = this.lastChargingStatus === null || this.lastChargingStatus !== chargingBool;
+                if (batteryChanged || chargingChanged) {
+                    this.logInfo(`battery updated (via legacy 'power'): ${batteryLevel}%`);
+                }
+                else {
+                    this.logDebug(`legacy 'power' battery unchanged: ${batteryLevel}% (charging: ${String(chargingBool)})`);
+                }
+                // Always update the in-memory cache
+                this.lastBatteryLevel = batteryLevel;
+                this.lastChargingStatus = chargingBool;
+            }
+            if (runtimeTranslate && typeof charging !== 'undefined') {
+                // Choose the target cluster to update. Prefer an explicit mapping
+                // if provided, otherwise fall back to rvcOperationalState when
+                // available.
+                const target = (this.clusterNameMap && this.clusterNameMap[cluster]) || 'rvcOperationalState';
+                const targetExists = this.clusters && (target in this.clusters);
+                const rvcExists = this.clusters && ('rvcOperationalState' in this.clusters);
+                if (targetExists || rvcExists) {
+                    const isCharging = charging === true || charging === 1;
+                    const opState = isCharging ? 65 : 66;
+                    const chosen = targetExists ? target : 'rvcOperationalState';
+                    try {
+                        await this.api.matter.updateAccessoryState(this.uuid, chosen, { operationalState: opState });
+                        this.log.debug(`[${this.displayName}] Translated legacy 'power' charging=${String(charging)} -> ${chosen}=${opState}`);
+                    }
+                    catch (e) {
+                        this.logDebug(`Failed to translate legacy 'power' charging=${String(charging)} -> ${chosen}: ${e?.message || e}`);
+                    }
+                    return;
+                }
+            }
+            const available = this.clusters ? Object.keys(this.clusters).join(', ') : '(none)';
+            this.logWarn(`Attempt to update legacy cluster 'power' but no mapping or supported target found. Available clusters: ${available}`);
+            return;
+        }
+        if (cluster === 'diagnostics') {
+            // diagnostics commonly carries an errorCode. If present and non-zero,
+            // translate to rvcOperationalState Error (3) when supported.
+            const errorCode = attributes.errorCode;
+            if (runtimeTranslate && typeof errorCode === 'number' && errorCode > 0) {
+                const target = (this.clusterNameMap && this.clusterNameMap[cluster]) || 'rvcOperationalState';
+                const targetExists = this.clusters && (target in this.clusters);
+                const rvcExists = this.clusters && ('rvcOperationalState' in this.clusters);
+                if (targetExists || rvcExists) {
+                    const chosen = targetExists ? target : 'rvcOperationalState';
+                    try {
+                        await this.api.matter.updateAccessoryState(this.uuid, chosen, { operationalState: 3 });
+                        this.logWarn(`[${this.displayName}] Translated legacy 'diagnostics' errorCode=${errorCode} -> ${chosen}=3 (Error)`);
+                    }
+                    catch (e) {
+                        this.logDebug(`Failed to translate legacy 'diagnostics' errorCode=${errorCode} -> ${chosen}: ${e?.message || e}`);
+                    }
+                    return;
+                }
+            }
+            const available = this.clusters ? Object.keys(this.clusters).join(', ') : '(none)';
+            this.logDebug(`Attempt to update legacy cluster 'diagnostics' but no mapping or supported target found. Available clusters: ${available}`);
+            return;
+        }
+        // Fallback: warn and skip unknown clusters to avoid Matter server errors.
+        const available = this.clusters ? Object.keys(this.clusters).join(', ') : '(none)';
+        this.logWarn(`Attempt to update unknown cluster '${cluster}' (mapped to '${mapped}'). Available clusters: ${available}`);
+    }
+    /**
+     * Log helper methods
+     */
+    logInfo(message, ...args) {
+        this.log.info(`[${this.displayName}] ${message}`, ...args);
+    }
+    logError(message, ...args) {
+        this.log.error(`[${this.displayName}] ${message}`, ...args);
+    }
+    logDebug(message, ...args) {
+        this.log.debug(`[${this.displayName}] ${message}`, ...args);
+    }
+    logWarn(message, ...args) {
+        this.log.warn(`[${this.displayName}] ${message}`, ...args);
+    }
+    /**
+     * Convert this class instance to a plain MatterAccessory object
+     * This is what gets registered with Homebridge
+     */
+    toAccessory() {
+        return {
+            uuid: this.uuid,
+            displayName: this.displayName,
+            deviceType: this.deviceType,
+            serialNumber: this.serialNumber,
+            manufacturer: this.manufacturer,
+            model: this.model,
+            firmwareRevision: this.firmwareRevision,
+            hardwareRevision: this.hardwareRevision,
+            context: this.context,
+            clusters: this.clusters,
+            handlers: this.handlers,
+            parts: this.parts,
+        };
+    }
+}
+//# sourceMappingURL=BaseMatterAccessory.js.map

package/dist/devices/BaseMatterAccessory.js.map

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

package/dist/devices/RoboticVacuumAccessory.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Robotic Vacuum Cleaner Accessory Class
+ *
+ * This is a comprehensive example demonstrating all available features
+ * of the RoboticVacuumCleaner device type including:
+ * - Multiple run modes (Idle, Cleaning, Mapping)
+ * - Multiple clean modes (Vacuum, Mop, Vacuum & Mop, Deep Clean)
+ * - Operational state management with realistic transitions
+ * - Service area (room) support
+ *
+ * IMPORTANT: Platform Matter accessories
+ * =======================================
+ * This vacuum is registered as a platform accessory using
+ * api.matter.registerPlatformAccessories(), which works the same as HAP.
+ * Platform accessories are registered synchronously and are immediately ready for use.
+ *
+ * Demo behavior:
+ * - Start/Resume: Sets run mode to "Cleaning", runs for 15/10 seconds, then returns to dock
+ * - Return to dock: Immediately sets "Idle" mode, then Seeking (5s) → Charging (3s) → Docked
+ * - Stop: Immediately stops and resets to "Idle" mode
+ * - Pause: Cancels automatic completion timer, keeps "Cleaning" mode
+ */
+import type { API, Logger } from 'homebridge';
+import type { SharkIqVacuum } from '../sharkiq-js/sharkiq.js';
+import { BaseMatterAccessory } from './BaseMatterAccessory.js';
+export declare class RoboticVacuumAccessory extends BaseMatterAccessory {
+    private activeTimers;
+    private lastRunMode;
+    protected lastBatteryLevel: number | null;
+    protected lastChargingStatus: boolean | null;
+    private lastOperationalState;
+    private lastRssi;
+    private lastSelectedAreas;
+    private lastCleanMode;
+    private readonly sharkDevice?;
+    private pollInterval?;
+    constructor(api: API, log: Logger, sharkDevice?: SharkIqVacuum, pollIntervalMs?: number);
+    /**
+     * Initialize cached runtime values from the Shark device wrapper where
+     * available, otherwise fall back to persisted accessory state exposed by the API.
+     */
+    private initCachedState;
+    /**
+     * Persist a named cache value into accessory context and keep in-memory copy.
+     * This centralizes writes so callers only need to update the in-memory field
+     * and call this to persist to Homebridge accessory.context.
+     */
+    private persistCache;
+    private startPolling;
+    private stopPolling;
+    private buildServiceAreaCluster;
+    private handleChangeRunMode;
+    private handleChangeCleanMode;
+    private handlePause;
+    private handleStop;
+    private handleStart;
+    private handleResume;
+    private handleGoHome;
+    private handleSelectAreas;
+    private handleSkipArea;
+    /**
+     * Helper method to clear all active timers
+     */
+    private clearTimers;
+    /**
+     * Helper method to initiate return to dock sequence
+     * Can be called synchronously from other handlers
+     */
+    private returnToDock;
+    /**
+     * Update Methods - Use these to update the vacuum state from your API/device
+     *
+     * Since this is a platform accessory, state updates work immediately after registration.
+     */
+    updateOperationalState(state: number): void;
+    updateRunMode(mode: number): void;
+    updateCleanMode(mode: number): void;
+    updateSelectedAreas(areaIds: number[]): void;
+    updateCurrentArea(areaId: number | null): void;
+    updateProgress(progress: Array<{
+        areaId: number;
+        status: number;
+    }>): void;
+}
+//# sourceMappingURL=RoboticVacuumAccessory.d.ts.map

package/dist/devices/RoboticVacuumAccessory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RoboticVacuumAccessory.d.ts","sourceRoot":"","sources":["../../src/devices/RoboticVacuumAccessory.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAkB,MAAM,YAAY,CAAA;AAE7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAG7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAE9D,qBAAa,sBAAuB,SAAQ,mBAAmB;IAC7D,OAAO,CAAC,YAAY,CAAuB;IAE3C,OAAO,CAAC,WAAW,CAAsB;IAEzC,SAAS,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAO;IAChD,SAAS,CAAC,kBAAkB,EAAE,OAAO,GAAG,IAAI,CAAO;IAEnD,OAAO,CAAC,oBAAoB,CAAsB;IAElD,OAAO,CAAC,QAAQ,CAAsB;IAEtC,OAAO,CAAC,iBAAiB,CAAwB;IAEjD,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAe;IAC5C,OAAO,CAAC,YAAY,CAAC,CAAgB;gBAEzB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,aAAa,EAAE,cAAc,CAAC,EAAE,MAAM;IAmMvF;;;OAGG;IACH,OAAO,CAAC,eAAe;IAkJvB;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,YAAY;IAwKpB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,uBAAuB;YAqCjB,mBAAmB;YAoDnB,qBAAqB;YA4BrB,WAAW;YAaX,UAAU;YAcV,WAAW;YA0BX,YAAY;YA0BZ,YAAY;YAuBZ,iBAAiB;YAsBjB,cAAc;IAQ5B;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;;OAGG;IACH,OAAO,CAAC,YAAY;IA0BpB;;;;OAIG;IAEI,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IA2B3C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAmBjC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IA8BnC,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAkC5C,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAU9C,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;CAIjF"}