@apocaliss92/nodedreame 1.6.0 → 1.6.1

package/dist/index.d.cts

@@ -1280,6 +1280,16 @@ declare class VacuumDevice extends BaseDevice<VacuumDeviceEvents> {
      * when the value is unobserved or the feature is not representable.
      */
     aiFeature(feature: DreameAiFeature): boolean | null;
+    /**
+     * Seed {@link aiDetectionRaw} from the CLOUD SHADOW (the last value the robot
+     * pushed for `AI_DETECTION`, siid 4 piid 22) WITHOUT waking it. The AI-obstacle
+     * toggles are STATIC settings the robot rarely re-pushes over MQTT, so a fresh
+     * connect to an idle robot has no value cached — call this on activate to
+     * surface the current toggles. Emits the usual `propertyChanged`/`stateChanged`
+     * (so a watching consumer re-decodes) and returns the resolved raw value
+     * (`null` when the model has no AI detection or the shadow carries none yet).
+     */
+    refreshAiDetection(): Promise<AiDetectionRaw>;
     /**
      * Toggle ONE AI-obstacle feature, preserving the others via a read-modify-write
      * of the packed `AI_DETECTION` property (mirrors Tasshack `set_ai_detection`).

package/dist/index.d.ts

@@ -1280,6 +1280,16 @@ declare class VacuumDevice extends BaseDevice<VacuumDeviceEvents> {
      * when the value is unobserved or the feature is not representable.
      */
     aiFeature(feature: DreameAiFeature): boolean | null;
+    /**
+     * Seed {@link aiDetectionRaw} from the CLOUD SHADOW (the last value the robot
+     * pushed for `AI_DETECTION`, siid 4 piid 22) WITHOUT waking it. The AI-obstacle
+     * toggles are STATIC settings the robot rarely re-pushes over MQTT, so a fresh
+     * connect to an idle robot has no value cached — call this on activate to
+     * surface the current toggles. Emits the usual `propertyChanged`/`stateChanged`
+     * (so a watching consumer re-decodes) and returns the resolved raw value
+     * (`null` when the model has no AI detection or the shadow carries none yet).
+     */
+    refreshAiDetection(): Promise<AiDetectionRaw>;
     /**
      * Toggle ONE AI-obstacle feature, preserving the others via a read-modify-write
      * of the packed `AI_DETECTION` property (mirrors Tasshack `set_ai_detection`).

package/dist/index.js

@@ -1,6 +1,6 @@
 // src/support/version.ts
 var LIBRARY_NAME = "nodedreame";
-var LIBRARY_VERSION = "1.6.0";
+var LIBRARY_VERSION = "1.6.1";
 
 // src/transport/errors.ts
 var DreameError = class extends Error {
@@ -2793,6 +2793,20 @@ var VacuumDevice = class _VacuumDevice extends BaseDevice {
   aiFeature(feature) {
     return decodeAiFeature(this.aiDetectionRaw, feature);
   }
+  /**
+   * Seed {@link aiDetectionRaw} from the CLOUD SHADOW (the last value the robot
+   * pushed for `AI_DETECTION`, siid 4 piid 22) WITHOUT waking it. The AI-obstacle
+   * toggles are STATIC settings the robot rarely re-pushes over MQTT, so a fresh
+   * connect to an idle robot has no value cached — call this on activate to
+   * surface the current toggles. Emits the usual `propertyChanged`/`stateChanged`
+   * (so a watching consumer re-decodes) and returns the resolved raw value
+   * (`null` when the model has no AI detection or the shadow carries none yet).
+   */
+  async refreshAiDetection() {
+    if (!this.#caps.hasAiObstacleDetection) return null;
+    await this.refreshCachedProperties([VACUUM_PROP.AI_DETECTION]);
+    return this.aiDetectionRaw;
+  }
   /**
    * Toggle ONE AI-obstacle feature, preserving the others via a read-modify-write
    * of the packed `AI_DETECTION` property (mirrors Tasshack `set_ai_detection`).