@apocaliss92/nodedreame 1.0.0 → 1.2.0

package/dist/index.js

@@ -285,6 +285,16 @@ var PropertyResultSchema = z.object({
   value: z.unknown().optional(),
   code: z.number().optional()
 }).passthrough();
+var CachedPropEntrySchema = z.object({
+  key: z.string(),
+  value: z.unknown().optional(),
+  updateDate: z.number().optional()
+}).passthrough();
+var CachedPropsResponseSchema = z.object({
+  code: z.number().optional(),
+  msg: z.string().optional(),
+  data: z.array(CachedPropEntrySchema).optional()
+}).passthrough();
 var SendCommandResponseSchema = z.object({
   code: z.number().optional(),
   msg: z.string().optional(),
@@ -474,6 +484,57 @@ async function getProperties(base, props, opts = {}) {
   const res = await sendCommand({ ...base, ...opts, method: "get_properties", params });
   return extractResultArray(res, "get_properties");
 }
+async function getCachedProperties(base, props, opts = {}) {
+  const ctx = base.ctx ?? RequestContext.from({ ...base, host: base.apiHost });
+  const keys = props.map((p) => `${p.siid}.${p.piid}`).join(",");
+  const signal = opts.signal ?? base.signal;
+  const timeoutMs = opts.timeoutMs ?? base.timeoutMs;
+  const raw = await httpPostJsonBody({
+    ctx,
+    path: "/dreame-user-iot/iotstatus/props",
+    accessToken: base.session.accessToken,
+    body: { did: base.did, keys },
+    context: "cached properties",
+    ...signal !== void 0 ? { signal } : {},
+    ...timeoutMs !== void 0 ? { timeoutMs } : {}
+  });
+  const parsed = CachedPropsResponseSchema.parse(raw);
+  if (parsed.code !== void 0 && parsed.code !== 0) {
+    throw new DreameApiError(
+      `cached properties rejected: code=${parsed.code} msg=${parsed.msg ?? "?"}`,
+      200,
+      parsed
+    );
+  }
+  return (parsed.data ?? []).flatMap((entry) => {
+    const [siidStr, piidStr] = entry.key.split(".");
+    const siid = Number(siidStr);
+    const piid = Number(piidStr);
+    if (!Number.isFinite(siid) || !Number.isFinite(piid)) {
+      return [];
+    }
+    const result = { siid, piid, value: coerceShadowValue(entry.value) };
+    if (entry.updateDate !== void 0) {
+      result.updateDate = entry.updateDate;
+    }
+    return [result];
+  });
+}
+function coerceShadowValue(value) {
+  if (typeof value !== "string") {
+    return value;
+  }
+  if (value === "true") {
+    return true;
+  }
+  if (value === "false") {
+    return false;
+  }
+  if (value.trim() !== "" && Number.isFinite(Number(value))) {
+    return Number(value);
+  }
+  return value;
+}
 async function setProperties(base, writes, opts = {}) {
   const params = writes.map((p) => ({
     did: base.did,
@@ -851,6 +912,7 @@ function defaultBaseDeviceDeps() {
   return {
     createPush: (device, session, region) => new DreamePush({ device, session, region }),
     getProperties: (base, props) => getProperties(base, props),
+    getCachedProperties: (base, props) => getCachedProperties(base, props),
     setProperties: (base, writes) => setProperties(base, writes),
     callAction: (base, action) => callAction(base, action)
   };
@@ -939,6 +1001,23 @@ var BaseDevice = class extends TypedEmitter {
   async refreshProperties(props) {
     this.#assertOpen();
     const results = await this.#deps.getProperties(this.#base(), props);
+    this.#seedFromResults(results);
+    return results;
+  }
+  /**
+   * Read the CLOUD-CACHED (shadow) values of `props` WITHOUT waking the device,
+   * update the cache, and emit `propertyChanged`/`stateChanged` just like
+   * {@link refreshProperties} — but sourced from the cloud shadow endpoint, so
+   * it works for standby/offline robots (and never surfaces a false 80001).
+   */
+  async refreshCachedProperties(props) {
+    this.#assertOpen();
+    const results = await this.#deps.getCachedProperties(this.#base(), props);
+    this.#seedFromResults(results);
+    return results;
+  }
+  /** Mirror a PropertyResult[] into the cache + emit the change events. */
+  #seedFromResults(results) {
     const changes = [];
     for (const r of results) {
       if (typeof r.siid === "number" && typeof r.piid === "number") {
@@ -948,7 +1027,6 @@ var BaseDevice = class extends TypedEmitter {
     if (changes.length > 0) {
       this.#onProperties(changes);
     }
-    return results;
   }
   /** Write a property to the device. */
   async setProperty(write) {
@@ -1148,11 +1226,27 @@ var MiotState = /* @__PURE__ */ ((MiotState2) => {
   MiotState2[MiotState2["ReturnToEmpty"] = 28] = "ReturnToEmpty";
   MiotState2[MiotState2["WaitingForTask"] = 29] = "WaitingForTask";
   MiotState2[MiotState2["CleanWashboardBase"] = 30] = "CleanWashboardBase";
+  MiotState2[MiotState2["ReturningToDrain"] = 31] = "ReturningToDrain";
+  MiotState2[MiotState2["Draining"] = 32] = "Draining";
   MiotState2[MiotState2["AutoWaterDraining"] = 33] = "AutoWaterDraining";
+  MiotState2[MiotState2["Emptying"] = 34] = "Emptying";
+  MiotState2[MiotState2["DustBagDrying"] = 35] = "DustBagDrying";
+  MiotState2[MiotState2["DustBagDryingPaused"] = 36] = "DustBagDryingPaused";
+  MiotState2[MiotState2["HeadingToExtraCleaning"] = 37] = "HeadingToExtraCleaning";
+  MiotState2[MiotState2["ExtraCleaning"] = 38] = "ExtraCleaning";
+  MiotState2[MiotState2["FindingPetPaused"] = 95] = "FindingPetPaused";
+  MiotState2[MiotState2["FindingPet"] = 96] = "FindingPet";
   MiotState2[MiotState2["ShortcutRunning"] = 97] = "ShortcutRunning";
   MiotState2[MiotState2["CameraMonitoring"] = 98] = "CameraMonitoring";
   MiotState2[MiotState2["CameraMonitoringPaused"] = 99] = "CameraMonitoringPaused";
   MiotState2[MiotState2["InitialDeepClean"] = 101] = "InitialDeepClean";
+  MiotState2[MiotState2["InitialDeepCleanPaused"] = 102] = "InitialDeepCleanPaused";
+  MiotState2[MiotState2["Sanitizing"] = 103] = "Sanitizing";
+  MiotState2[MiotState2["SanitizingWithDry"] = 104] = "SanitizingWithDry";
+  MiotState2[MiotState2["ChangingMop"] = 105] = "ChangingMop";
+  MiotState2[MiotState2["ChangingMopPaused"] = 106] = "ChangingMopPaused";
+  MiotState2[MiotState2["FloorMaintaining"] = 107] = "FloorMaintaining";
+  MiotState2[MiotState2["FloorMaintainingPaused"] = 108] = "FloorMaintainingPaused";
   return MiotState2;
 })(MiotState || {});
 var ChargingStatus = /* @__PURE__ */ ((ChargingStatus2) => {
@@ -1184,21 +1278,87 @@ var CleaningMode = /* @__PURE__ */ ((CleaningMode2) => {
 var MiotError = /* @__PURE__ */ ((MiotError2) => {
   MiotError2[MiotError2["Clear"] = 0] = "Clear";
   MiotError2[MiotError2["WheelRotationAnomaly"] = 1] = "WheelRotationAnomaly";
+  MiotError2[MiotError2["Cliff"] = 2] = "Cliff";
+  MiotError2[MiotError2["Bumper"] = 3] = "Bumper";
+  MiotError2[MiotError2["Gesture"] = 4] = "Gesture";
+  MiotError2[MiotError2["BumperRepeat"] = 5] = "BumperRepeat";
+  MiotError2[MiotError2["DropRepeat"] = 6] = "DropRepeat";
+  MiotError2[MiotError2["OpticalFlow"] = 7] = "OpticalFlow";
+  MiotError2[MiotError2["Box"] = 8] = "Box";
+  MiotError2[MiotError2["TankBox"] = 9] = "TankBox";
+  MiotError2[MiotError2["WaterBoxEmpty"] = 10] = "WaterBoxEmpty";
+  MiotError2[MiotError2["BoxFull"] = 11] = "BoxFull";
+  MiotError2[MiotError2["Brush"] = 12] = "Brush";
+  MiotError2[MiotError2["SideBrush"] = 13] = "SideBrush";
+  MiotError2[MiotError2["Fan"] = 14] = "Fan";
+  MiotError2[MiotError2["LeftWheelMotor"] = 15] = "LeftWheelMotor";
+  MiotError2[MiotError2["RightWheelMotor"] = 16] = "RightWheelMotor";
+  MiotError2[MiotError2["TurnSuffocate"] = 17] = "TurnSuffocate";
   MiotError2[MiotError2["RobotLifted"] = 18] = "RobotLifted";
-  MiotError2[MiotError2["TaskComplete"] = 68] = "TaskComplete";
-  MiotError2[MiotError2["ManualMopInstallRequired"] = 74] = "ManualMopInstallRequired";
-  MiotError2[MiotError2["WastewaterTankFull"] = 105] = "WastewaterTankFull";
-  MiotError2[MiotError2["CleanWaterTankEmpty"] = 107] = "CleanWaterTankEmpty";
-  MiotError2[MiotError2["WashboardFilterNeedsCleaning"] = 114] = "WashboardFilterNeedsCleaning";
-  MiotError2[MiotError2["MopPadsMissing"] = 120] = "MopPadsMissing";
+  MiotError2[MiotError2["ChargerGet"] = 19] = "ChargerGet";
   MiotError2[MiotError2["BatteryLow"] = 20] = "BatteryLow";
   MiotError2[MiotError2["ChargeFault"] = 21] = "ChargeFault";
   MiotError2[MiotError2["BatteryPercentageAnomaly"] = 22] = "BatteryPercentageAnomaly";
+  MiotError2[MiotError2["Heart"] = 23] = "Heart";
+  MiotError2[MiotError2["CameraOcclusion"] = 24] = "CameraOcclusion";
+  MiotError2[MiotError2["Move"] = 25] = "Move";
+  MiotError2[MiotError2["FlowShielding"] = 26] = "FlowShielding";
+  MiotError2[MiotError2["InfraredShielding"] = 27] = "InfraredShielding";
   MiotError2[MiotError2["ChargeNoElectric"] = 28] = "ChargeNoElectric";
   MiotError2[MiotError2["BatteryFault"] = 29] = "BatteryFault";
+  MiotError2[MiotError2["FanSpeedError"] = 30] = "FanSpeedError";
+  MiotError2[MiotError2["LeftWheelSpeed"] = 31] = "LeftWheelSpeed";
+  MiotError2[MiotError2["RightWheelSpeed"] = 32] = "RightWheelSpeed";
+  MiotError2[MiotError2["Bmi055Acce"] = 33] = "Bmi055Acce";
+  MiotError2[MiotError2["Bmi055Gyro"] = 34] = "Bmi055Gyro";
+  MiotError2[MiotError2["Xv7001"] = 35] = "Xv7001";
+  MiotError2[MiotError2["LeftMagnet"] = 36] = "LeftMagnet";
+  MiotError2[MiotError2["RightMagnet"] = 37] = "RightMagnet";
+  MiotError2[MiotError2["FlowError"] = 38] = "FlowError";
+  MiotError2[MiotError2["InfraredFault"] = 39] = "InfraredFault";
+  MiotError2[MiotError2["CameraFault"] = 40] = "CameraFault";
+  MiotError2[MiotError2["StrongMagnet"] = 41] = "StrongMagnet";
+  MiotError2[MiotError2["WaterPump"] = 42] = "WaterPump";
+  MiotError2[MiotError2["Rtc"] = 43] = "Rtc";
+  MiotError2[MiotError2["AutoKeyTrig"] = 44] = "AutoKeyTrig";
+  MiotError2[MiotError2["P3v3"] = 45] = "P3v3";
+  MiotError2[MiotError2["CameraIdle"] = 46] = "CameraIdle";
+  MiotError2[MiotError2["Blocked"] = 47] = "Blocked";
+  MiotError2[MiotError2["LdsError"] = 48] = "LdsError";
+  MiotError2[MiotError2["LdsBumper"] = 49] = "LdsBumper";
+  MiotError2[MiotError2["WaterPump2"] = 50] = "WaterPump2";
+  MiotError2[MiotError2["FilterBlocked"] = 51] = "FilterBlocked";
+  MiotError2[MiotError2["Edge"] = 54] = "Edge";
+  MiotError2[MiotError2["Carpet"] = 55] = "Carpet";
+  MiotError2[MiotError2["Laser"] = 56] = "Laser";
+  MiotError2[MiotError2["Edge2"] = 57] = "Edge2";
+  MiotError2[MiotError2["Ultrasonic"] = 58] = "Ultrasonic";
+  MiotError2[MiotError2["NoGoZone"] = 59] = "NoGoZone";
+  MiotError2[MiotError2["Route"] = 61] = "Route";
+  MiotError2[MiotError2["Route2"] = 62] = "Route2";
+  MiotError2[MiotError2["Blocked2"] = 63] = "Blocked2";
+  MiotError2[MiotError2["Blocked3"] = 64] = "Blocked3";
+  MiotError2[MiotError2["Restricted"] = 65] = "Restricted";
+  MiotError2[MiotError2["Restricted2"] = 66] = "Restricted2";
+  MiotError2[MiotError2["Restricted3"] = 67] = "Restricted3";
+  MiotError2[MiotError2["TaskComplete"] = 68] = "TaskComplete";
+  MiotError2[MiotError2["MopRemoved"] = 69] = "MopRemoved";
+  MiotError2[MiotError2["MopRemoved2"] = 70] = "MopRemoved2";
+  MiotError2[MiotError2["MopPadStopRotate"] = 71] = "MopPadStopRotate";
+  MiotError2[MiotError2["MopPadStopRotate2"] = 72] = "MopPadStopRotate2";
+  MiotError2[MiotError2["ManualMopInstallRequired"] = 74] = "ManualMopInstallRequired";
   MiotError2[MiotError2["LowBatteryTurnOff"] = 75] = "LowBatteryTurnOff";
+  MiotError2[MiotError2["DirtyTankNotInstalled"] = 76] = "DirtyTankNotInstalled";
+  MiotError2[MiotError2["RobotInHiddenRoom"] = 78] = "RobotInHiddenRoom";
+  MiotError2[MiotError2["LdsFailedToLift"] = 79] = "LdsFailedToLift";
   MiotError2[MiotError2["RobotStuck"] = 80] = "RobotStuck";
   MiotError2[MiotError2["RobotStuckRepeat"] = 81] = "RobotStuckRepeat";
+  MiotError2[MiotError2["SlipperyFloor"] = 82] = "SlipperyFloor";
+  MiotError2[MiotError2["UnknownError"] = 84] = "UnknownError";
+  MiotError2[MiotError2["CheckMopInstall"] = 85] = "CheckMopInstall";
+  MiotError2[MiotError2["DirtyWaterTankFull"] = 86] = "DirtyWaterTankFull";
+  MiotError2[MiotError2["RetractableLegStuck"] = 88] = "RetractableLegStuck";
+  MiotError2[MiotError2["InternalError"] = 89] = "InternalError";
   MiotError2[MiotError2["RobotStuck2"] = 90] = "RobotStuck2";
   MiotError2[MiotError2["RobotStuckOnTables"] = 91] = "RobotStuckOnTables";
   MiotError2[MiotError2["RobotStuckOnPassage"] = 92] = "RobotStuckOnPassage";
@@ -1209,19 +1369,82 @@ var MiotError = /* @__PURE__ */ ((MiotError2) => {
   MiotError2[MiotError2["RobotStuckOnPet"] = 97] = "RobotStuckOnPet";
   MiotError2[MiotError2["RobotStuckOnSlipperySurface"] = 98] = "RobotStuckOnSlipperySurface";
   MiotError2[MiotError2["RobotStuckOnCarpet"] = 99] = "RobotStuckOnCarpet";
-  MiotError2[MiotError2["RobotStuckOnCurtain"] = 200] = "RobotStuckOnCurtain";
   MiotError2[MiotError2["BinFull"] = 101] = "BinFull";
+  MiotError2[MiotError2["BinOpen"] = 102] = "BinOpen";
+  MiotError2[MiotError2["BinOpen2"] = 103] = "BinOpen2";
+  MiotError2[MiotError2["BinFull2"] = 104] = "BinFull2";
+  MiotError2[MiotError2["WastewaterTankFull"] = 105] = "WastewaterTankFull";
+  MiotError2[MiotError2["DirtyWaterTank"] = 106] = "DirtyWaterTank";
+  MiotError2[MiotError2["CleanWaterTankEmpty"] = 107] = "CleanWaterTankEmpty";
+  MiotError2[MiotError2["DirtyWaterTank2"] = 108] = "DirtyWaterTank2";
+  MiotError2[MiotError2["DirtyWaterTankBlocked"] = 109] = "DirtyWaterTankBlocked";
+  MiotError2[MiotError2["DirtyWaterTankPump"] = 110] = "DirtyWaterTankPump";
+  MiotError2[MiotError2["MopPad"] = 111] = "MopPad";
+  MiotError2[MiotError2["WetMopPad"] = 112] = "WetMopPad";
+  MiotError2[MiotError2["WashboardFilterNeedsCleaning"] = 114] = "WashboardFilterNeedsCleaning";
+  MiotError2[MiotError2["CleanTankLevel"] = 116] = "CleanTankLevel";
   MiotError2[MiotError2["StationDisconnected"] = 117] = "StationDisconnected";
+  MiotError2[MiotError2["DirtyTankLevel"] = 118] = "DirtyTankLevel";
+  MiotError2[MiotError2["WashboardLevel"] = 119] = "WashboardLevel";
+  MiotError2[MiotError2["MopPadsMissing"] = 120] = "MopPadsMissing";
   MiotError2[MiotError2["DustBagFull"] = 121] = "DustBagFull";
+  MiotError2[MiotError2["UnknownWarning"] = 122] = "UnknownWarning";
+  MiotError2[MiotError2["SelfTestFailed"] = 123] = "SelfTestFailed";
+  MiotError2[MiotError2["WashboardNotWorking"] = 124] = "WashboardNotWorking";
+  MiotError2[MiotError2["DrainageFailed"] = 125] = "DrainageFailed";
+  MiotError2[MiotError2["MopNotDetected"] = 126] = "MopNotDetected";
+  MiotError2[MiotError2["MopHolderError"] = 127] = "MopHolderError";
+  MiotError2[MiotError2["DockError"] = 128] = "DockError";
+  MiotError2[MiotError2["WashFailed"] = 129] = "WashFailed";
+  MiotError2[MiotError2["RobotStuckOnCurtain"] = 200] = "RobotStuckOnCurtain";
+  MiotError2[MiotError2["EdgeMopStopRotate"] = 201] = "EdgeMopStopRotate";
+  MiotError2[MiotError2["EdgeMopDetached"] = 202] = "EdgeMopDetached";
+  MiotError2[MiotError2["ChassisLiftMalfunction"] = 203] = "ChassisLiftMalfunction";
+  MiotError2[MiotError2["InternalError2"] = 207] = "InternalError2";
+  MiotError2[MiotError2["MopCoverError"] = 209] = "MopCoverError";
+  MiotError2[MiotError2["RollerMopError"] = 210] = "RollerMopError";
+  MiotError2[MiotError2["OnboardWaterTankEmpty"] = 213] = "OnboardWaterTankEmpty";
+  MiotError2[MiotError2["OnboardDirtyWaterTankFull"] = 214] = "OnboardDirtyWaterTankFull";
+  MiotError2[MiotError2["MopNotInstalled"] = 215] = "MopNotInstalled";
+  MiotError2[MiotError2["RollerMopError2"] = 218] = "RollerMopError2";
+  MiotError2[MiotError2["FluffingRollerError"] = 222] = "FluffingRollerError";
+  MiotError2[MiotError2["MopCoverError2"] = 223] = "MopCoverError2";
+  MiotError2[MiotError2["BlockedByObstacle"] = 226] = "BlockedByObstacle";
+  MiotError2[MiotError2["ReturnToChargeFailed"] = 1e3] = "ReturnToChargeFailed";
   return MiotError2;
 })(MiotError || {});
 var TaskStatus = /* @__PURE__ */ ((TaskStatus2) => {
+  TaskStatus2[TaskStatus2["Completed"] = 0] = "Completed";
   TaskStatus2[TaskStatus2["InterruptedOrPaused"] = 1] = "InterruptedOrPaused";
   TaskStatus2[TaskStatus2["Active"] = 2] = "Active";
   TaskStatus2[TaskStatus2["Transitioning"] = 3] = "Transitioning";
+  TaskStatus2[TaskStatus2["SpotCleaning"] = 4] = "SpotCleaning";
+  TaskStatus2[TaskStatus2["FastMapping"] = 5] = "FastMapping";
   TaskStatus2[TaskStatus2["OnDockIdle"] = 6] = "OnDockIdle";
+  TaskStatus2[TaskStatus2["ZoneCleaningPaused"] = 7] = "ZoneCleaningPaused";
+  TaskStatus2[TaskStatus2["SegmentCleaningPaused"] = 8] = "SegmentCleaningPaused";
+  TaskStatus2[TaskStatus2["SpotCleaningPaused"] = 9] = "SpotCleaningPaused";
+  TaskStatus2[TaskStatus2["MapCleaningPaused"] = 10] = "MapCleaningPaused";
+  TaskStatus2[TaskStatus2["DockingPaused"] = 11] = "DockingPaused";
   TaskStatus2[TaskStatus2["TransientPauseEdge"] = 12] = "TransientPauseEdge";
+  TaskStatus2[TaskStatus2["SegmentMoppingPaused"] = 13] = "SegmentMoppingPaused";
   TaskStatus2[TaskStatus2["NeedsIntervention"] = 14] = "NeedsIntervention";
+  TaskStatus2[TaskStatus2["AutoMoppingPaused"] = 15] = "AutoMoppingPaused";
+  TaskStatus2[TaskStatus2["AutoDockingPaused"] = 16] = "AutoDockingPaused";
+  TaskStatus2[TaskStatus2["SegmentDockingPaused"] = 17] = "SegmentDockingPaused";
+  TaskStatus2[TaskStatus2["ZoneDockingPaused"] = 18] = "ZoneDockingPaused";
+  TaskStatus2[TaskStatus2["CruisingPath"] = 20] = "CruisingPath";
+  TaskStatus2[TaskStatus2["CruisingPathPaused"] = 21] = "CruisingPathPaused";
+  TaskStatus2[TaskStatus2["CruisingPoint"] = 22] = "CruisingPoint";
+  TaskStatus2[TaskStatus2["CruisingPointPaused"] = 23] = "CruisingPointPaused";
+  TaskStatus2[TaskStatus2["SummonCleanPaused"] = 24] = "SummonCleanPaused";
+  TaskStatus2[TaskStatus2["ReturningInstallMop"] = 25] = "ReturningInstallMop";
+  TaskStatus2[TaskStatus2["ReturningRemoveMop"] = 26] = "ReturningRemoveMop";
+  TaskStatus2[TaskStatus2["StationCleaning"] = 27] = "StationCleaning";
+  TaskStatus2[TaskStatus2["PetFinding"] = 30] = "PetFinding";
+  TaskStatus2[TaskStatus2["AutoCleaningWashingPaused"] = 31] = "AutoCleaningWashingPaused";
+  TaskStatus2[TaskStatus2["AreaCleaningWashingPaused"] = 32] = "AreaCleaningWashingPaused";
+  TaskStatus2[TaskStatus2["CustomCleaningWashingPaused"] = 33] = "CustomCleaningWashingPaused";
   return TaskStatus2;
 })(TaskStatus || {});
 
@@ -2342,7 +2565,7 @@ var TASK = enumLookup([
   12 /* TransientPauseEdge */,
   14 /* NeedsIntervention */
 ]);
-var VacuumDevice = class extends BaseDevice {
+var VacuumDevice = class _VacuumDevice extends BaseDevice {
   #caps;
   #lastMap = null;
   constructor(input) {
@@ -2358,6 +2581,18 @@ var VacuumDevice = class extends BaseDevice {
   get vacuumCapabilities() {
     return this.#caps;
   }
+  /**
+   * The suction levels this model supports, as a {@link SuctionLevel} enum array
+   * (from the capability record). Lets a consumer see which fan speeds are
+   * selectable without reaching into {@link vacuumCapabilities}.
+   */
+  get supportedSuctionLevels() {
+    return this.#caps.supportedSuctionLevels;
+  }
+  /** The water/mop volumes this model supports, as a {@link WaterVolume} enum array. */
+  get supportedWaterVolumes() {
+    return this.#caps.supportedWaterVolumes;
+  }
   #num(siid, piid) {
     return asNum(this.getProperty(siid, piid)?.value);
   }
@@ -2557,6 +2792,16 @@ var VacuumDevice = class extends BaseDevice {
     const points = [[Math.round(point.x), Math.round(point.y), repeats, fan, water]];
     return this.#startCustom(CUSTOM_CLEAN_MODE.SPOT, { points });
   }
+  /**
+   * Seed the cache from the CLOUD SHADOW (last-known values) WITHOUT waking the
+   * robot — reads {@link VacuumDevice.DEFAULT_PROPS} from the cloud-cached
+   * endpoint. After it resolves, every typed getter (status/battery/suction/
+   * water/cleaningMode/error/charging…) reflects the cached values, so a
+   * standby/docked vacuum reports its state exactly as the Dreamehome app does.
+   */
+  async refreshFromCache() {
+    await this.refreshCachedProperties([..._VacuumDevice.DEFAULT_PROPS]);
+  }
   // -- maps ---------------------------------------------------------------
   /** The most-recently-decoded map, or `null` until {@link getMap} succeeds. */
   get lastMap() {
@@ -2710,6 +2955,83 @@ var MowerTaskStatus = /* @__PURE__ */ ((MowerTaskStatus2) => {
   MowerTaskStatus2[MowerTaskStatus2["SpotIncomplete"] = 7] = "SpotIncomplete";
   return MowerTaskStatus2;
 })(MowerTaskStatus || {});
+var MowerFault = /* @__PURE__ */ ((MowerFault2) => {
+  MowerFault2[MowerFault2["NoDeviceCode"] = 0] = "NoDeviceCode";
+  MowerFault2[MowerFault2["Tilted"] = 1] = "Tilted";
+  MowerFault2[MowerFault2["Trapped"] = 2] = "Trapped";
+  MowerFault2[MowerFault2["NarrowPathToStation"] = 3] = "NarrowPathToStation";
+  MowerFault2[MowerFault2["LeftWheel"] = 4] = "LeftWheel";
+  MowerFault2[MowerFault2["RightWheel"] = 5] = "RightWheel";
+  MowerFault2[MowerFault2["LiftMotor"] = 6] = "LiftMotor";
+  MowerFault2[MowerFault2["Cutter"] = 7] = "Cutter";
+  MowerFault2[MowerFault2["SidedMotor"] = 8] = "SidedMotor";
+  MowerFault2[MowerFault2["CrashPlate"] = 9] = "CrashPlate";
+  MowerFault2[MowerFault2["Charging"] = 10] = "Charging";
+  MowerFault2[MowerFault2["BatteryOverheat"] = 11] = "BatteryOverheat";
+  MowerFault2[MowerFault2["LidarCovered"] = 12] = "LidarCovered";
+  MowerFault2[MowerFault2["LidarOverheatWithoutMap"] = 13] = "LidarOverheatWithoutMap";
+  MowerFault2[MowerFault2["LidarOverheatWithMap"] = 14] = "LidarOverheatWithMap";
+  MowerFault2[MowerFault2["LidarOverheat"] = 15] = "LidarOverheat";
+  MowerFault2[MowerFault2["LidarDirty"] = 16] = "LidarDirty";
+  MowerFault2[MowerFault2["LidarAbnormal"] = 17] = "LidarAbnormal";
+  MowerFault2[MowerFault2["LocationWeak"] = 18] = "LocationWeak";
+  MowerFault2[MowerFault2["LocationLost"] = 19] = "LocationLost";
+  MowerFault2[MowerFault2["Sensor"] = 20] = "Sensor";
+  MowerFault2[MowerFault2["InForbiddenArea"] = 21] = "InForbiddenArea";
+  MowerFault2[MowerFault2["OutOfMap"] = 22] = "OutOfMap";
+  MowerFault2[MowerFault2["EmergencyStop"] = 23] = "EmergencyStop";
+  MowerFault2[MowerFault2["BatteryLow"] = 24] = "BatteryLow";
+  MowerFault2[MowerFault2["MapFileCrack"] = 25] = "MapFileCrack";
+  MowerFault2[MowerFault2["AwayFromMap"] = 26] = "AwayFromMap";
+  MowerFault2[MowerFault2["HumanDetected"] = 27] = "HumanDetected";
+  MowerFault2[MowerFault2["BladeLoss"] = 28] = "BladeLoss";
+  MowerFault2[MowerFault2["StationLoss"] = 29] = "StationLoss";
+  MowerFault2[MowerFault2["MaintainLoss"] = 30] = "MaintainLoss";
+  MowerFault2[MowerFault2["BackChargeFailed"] = 31] = "BackChargeFailed";
+  MowerFault2[MowerFault2["DockingFailed"] = 32] = "DockingFailed";
+  MowerFault2[MowerFault2["LocatingFailedWithMap"] = 33] = "LocatingFailedWithMap";
+  MowerFault2[MowerFault2["LocatingFailedWithoutMap"] = 34] = "LocatingFailedWithoutMap";
+  MowerFault2[MowerFault2["LocatingAbnormal"] = 35] = "LocatingAbnormal";
+  MowerFault2[MowerFault2["TaskStartFailed"] = 36] = "TaskStartFailed";
+  MowerFault2[MowerFault2["PathImpassable"] = 37] = "PathImpassable";
+  MowerFault2[MowerFault2["LidarDirtyWarning"] = 38] = "LidarDirtyWarning";
+  MowerFault2[MowerFault2["CamDirty"] = 39] = "CamDirty";
+  MowerFault2[MowerFault2["CamAbnormal"] = 40] = "CamAbnormal";
+  MowerFault2[MowerFault2["CamCover"] = 41] = "CamCover";
+  MowerFault2[MowerFault2["BatteryOverheatWarning"] = 42] = "BatteryOverheatWarning";
+  MowerFault2[MowerFault2["BatteryTempLow"] = 43] = "BatteryTempLow";
+  MowerFault2[MowerFault2["AutobuildBorder"] = 44] = "AutobuildBorder";
+  MowerFault2[MowerFault2["AutobuildSide"] = 45] = "AutobuildSide";
+  MowerFault2[MowerFault2["BorderFinish"] = 46] = "BorderFinish";
+  MowerFault2[MowerFault2["NewMap"] = 47] = "NewMap";
+  MowerFault2[MowerFault2["TaskFinish"] = 48] = "TaskFinish";
+  MowerFault2[MowerFault2["DestinationNotReachable"] = 49] = "DestinationNotReachable";
+  MowerFault2[MowerFault2["TaskStart"] = 50] = "TaskStart";
+  MowerFault2[MowerFault2["CruiseStart"] = 51] = "CruiseStart";
+  MowerFault2[MowerFault2["PointAndGoStart"] = 52] = "PointAndGoStart";
+  MowerFault2[MowerFault2["ScheduleStart"] = 53] = "ScheduleStart";
+  MowerFault2[MowerFault2["BatteryLowReturning"] = 54] = "BatteryLowReturning";
+  MowerFault2[MowerFault2["BatteryLowScheduleSuspend"] = 55] = "BatteryLowScheduleSuspend";
+  MowerFault2[MowerFault2["BadWeatherProtecting"] = 56] = "BadWeatherProtecting";
+  MowerFault2[MowerFault2["RainScheduleInterupted"] = 57] = "RainScheduleInterupted";
+  MowerFault2[MowerFault2["RainScheduleSuspend"] = 58] = "RainScheduleSuspend";
+  MowerFault2[MowerFault2["ForzenReturning"] = 59] = "ForzenReturning";
+  MowerFault2[MowerFault2["FrozenScheduleSuspend"] = 60] = "FrozenScheduleSuspend";
+  MowerFault2[MowerFault2["NotDisturbReturning"] = 61] = "NotDisturbReturning";
+  MowerFault2[MowerFault2["NotDisturbScheduleSuspend"] = 62] = "NotDisturbScheduleSuspend";
+  MowerFault2[MowerFault2["WorkingScheduleSuspend"] = 63] = "WorkingScheduleSuspend";
+  MowerFault2[MowerFault2["RemoteControlingScheduleSuspend"] = 64] = "RemoteControlingScheduleSuspend";
+  MowerFault2[MowerFault2["EmergencyStoppedScheduleSuspend"] = 65] = "EmergencyStoppedScheduleSuspend";
+  MowerFault2[MowerFault2["TopCoverOpenScheduleSuspend"] = 66] = "TopCoverOpenScheduleSuspend";
+  MowerFault2[MowerFault2["FaultModeScheduleSuspend"] = 67] = "FaultModeScheduleSuspend";
+  MowerFault2[MowerFault2["ScheduleTimeout"] = 68] = "ScheduleTimeout";
+  MowerFault2[MowerFault2["StationNotConnectedToWorkingArea"] = 69] = "StationNotConnectedToWorkingArea";
+  MowerFault2[MowerFault2["ContinueFromBreakpoint"] = 70] = "ContinueFromBreakpoint";
+  MowerFault2[MowerFault2["IdleTimeoutReturning"] = 71] = "IdleTimeoutReturning";
+  MowerFault2[MowerFault2["PauseTimeoutReturning"] = 72] = "PauseTimeoutReturning";
+  MowerFault2[MowerFault2["TopCoverOpen"] = 73] = "TopCoverOpen";
+  return MowerFault2;
+})(MowerFault || {});
 
 // src/models/mower/decode.ts
 function isRecord(v) {
@@ -3389,7 +3711,13 @@ var STATUS = enumLookup(
 var CHARGING2 = enumLookup(
   Object.values(MowerChargingStatus).filter((v) => typeof v === "number")
 );
-var MowerDevice = class extends BaseDevice {
+var TASK_STATUS = enumLookup(
+  Object.values(MowerTaskStatus).filter((v) => typeof v === "number")
+);
+var FAULT = enumLookup(
+  Object.values(MowerFault).filter((v) => typeof v === "number")
+);
+var MowerDevice = class _MowerDevice extends BaseDevice {
   #caps;
   #fetchBatch;
   #lastMap = null;
@@ -3437,6 +3765,25 @@ var MowerDevice = class extends BaseDevice {
   get taskStatusRaw() {
     return this.#num(MOWER_PROP.TASK_STATUS.siid, MOWER_PROP.TASK_STATUS.piid);
   }
+  /**
+   * TASK_STATUS (5:104) decoded to {@link MowerTaskStatus}, or null. The donor
+   * names only code 7 (SpotIncomplete); codes 2/3/10/13 are documented "Unknown
+   * task status" and intentionally surface as raw via {@link taskStatusRaw}.
+   */
+  get taskStatus() {
+    return TASK_STATUS(this.taskStatusRaw);
+  }
+  get faultRaw() {
+    return this.#num(MOWER_PROP.DEVICE_CODE.siid, MOWER_PROP.DEVICE_CODE.piid);
+  }
+  /**
+   * DEVICE_CODE (2:2) decoded to a {@link MowerFault} (the donor's
+   * BASE_DEVICE_CODES registry, 0..73), or null for a model-specific/undocumented
+   * code — which still surfaces as the raw number via {@link faultRaw}.
+   */
+  get fault() {
+    return FAULT(this.faultRaw);
+  }
   /** Parsed scheduling task descriptor (2:50), or null. */
   get task() {
     return parseTaskDescriptor(
@@ -3529,6 +3876,16 @@ var MowerDevice = class extends BaseDevice {
     }
     return this.#sendTask(buildSpotPayload(spotAreaIds.map((s) => Math.trunc(s))));
   }
+  /**
+   * Seed the cache from the CLOUD SHADOW (last-known values) WITHOUT waking the
+   * mower — reads {@link MowerDevice.DEFAULT_PROPS} from the cloud-cached
+   * endpoint. After it resolves, every typed getter (status/battery/charging/
+   * coverage/task/controlAction…) reflects the cached values, so a docked/
+   * standby mower reports its state exactly as the Dreamehome app does.
+   */
+  async refreshFromCache() {
+    await this.refreshCachedProperties([..._MowerDevice.DEFAULT_PROPS]);
+  }
   // -- maps ---------------------------------------------------------------
   /** The most-recently-parsed map, or `null` until {@link getMap} succeeds. */
   get lastMap() {
@@ -3569,6 +3926,7 @@ var MowerDevice = class extends BaseDevice {
   /** Props worth seeding on start() / polling — exported for the facade. */
   static DEFAULT_PROPS = [
     MOWER_PROP.STATUS,
+    MOWER_PROP.DEVICE_CODE,
     MOWER_PROP.BATTERY,
     MOWER_PROP.CHARGING_STATUS,
     MOWER_PROP.TASK_STATUS,
@@ -3742,6 +4100,7 @@ export {
   MowerChargingStatus,
   MowerControlAction,
   MowerDevice,
+  MowerFault,
   MowerStatus,
   MowerTaskStatus,
   Nodreame,