@apocaliss92/nodedreame 1.12.4 → 1.12.5

package/dist/index.d.cts

@@ -892,6 +892,19 @@ declare function encodeAutoSwitchWrite(key: AutoSwitchKey, value: number): strin
  */
 /** Stable consumable keys (kebab-case so a consumer can use them verbatim). */
 type DreameConsumableKey = 'main-brush' | 'side-brush' | 'filter' | 'sensor' | 'tank-filter' | 'mop-pad' | 'silver-ion' | 'detergent' | 'squeegee' | 'deodorizer' | 'wheel' | 'scale-inhibitor' | 'dust-bag';
+/** The unit a consumable's time-left property counts in. */
+type ConsumableTimeLeftUnit = 'hours' | 'days';
+/** A consumable's time-left property: where it lives and what it counts in. */
+interface ConsumableTimeLeftSpec {
+    readonly siid: number;
+    readonly piid: number;
+    readonly unit: ConsumableTimeLeftUnit;
+}
+/** A consumable's time left as the robot reports it. */
+interface ConsumableTimeLeft {
+    readonly value: number;
+    readonly unit: ConsumableTimeLeftUnit;
+}
 /** One consumable's wire coordinates: remaining-life property + optional reset action. */
 interface ConsumableSpec {
     readonly key: DreameConsumableKey;
@@ -901,6 +914,11 @@ interface ConsumableSpec {
         readonly siid: number;
         readonly piid: number;
     };
+    /**
+     * The time-left twin on the same service (the other piid), or null when the
+     * consumable has none. A reset rewrites it together with {@link life}.
+     */
+    readonly timeLeft: ConsumableTimeLeftSpec | null;
     /** "Mark replaced / reset life" action, or null when the model exposes none. */
     readonly reset: {
         readonly siid: number;
@@ -910,7 +928,18 @@ interface ConsumableSpec {
 /**
  * Every consumable nodedreame knows. The reset action shares the consumable's
  * service `siid` with `aiid 1` (Tasshack action map). `dust-bag` has a life
- * property but no reset action.
+ * property but no reset action and no time-left twin.
+ *
+ * Time-left twins: the service's other piid. Measured against the Dreame app on
+ * an r2538z on 2026-09-26 ("Tempo residuo"): main brush 9/1 = 271 h at 90 %,
+ * side brush 10/1 = 171 h at 85 %, filter 11/2 = 121 h at 80 %, sensors 16/2 =
+ * 1 h at 4 % — each consistent with its life (300/200/150/30 h). Wheel 30/1 and
+ * scale inhibitor 31/1 count DAYS (HA units for that robot). The rest are the
+ * mapping the camstack Dreame addon already shipped; not measured on a robot
+ * that reports them.
+ *
+ * Labels `Sensor Dirty` / `Wheel Dirty` are the maintenance the app and HA name
+ * (clean the sensors / wheels) — a bare "Sensor at 4 %" read as a broken part.
  */
 declare const VACUUM_CONSUMABLES: readonly ConsumableSpec[];
 /** Lookup a consumable spec by key (undefined for an unknown key). */
@@ -927,6 +956,24 @@ interface ConsumableReading {
     readonly leftPct: number;
     readonly resettable: boolean;
 }
+/** Where a post-reset re-read came from: the robot itself, or the cloud shadow. */
+type ConsumableRefreshSource = 'device' | 'cloud-shadow';
+/**
+ * The outcome of a consumable reset. The action has SUCCEEDED whenever this
+ * resolves; `refreshedFrom` says whether the values after it were re-read.
+ * `null` there means both reads failed — `leftPct`/`timeLeft` are then `null`
+ * (unknown, not zero) and the cache still holds the pre-reset values.
+ * `refreshError` is why the better source was not used: the live read's error
+ * when the shadow answered, the shadow's when neither did, else `null`.
+ */
+interface ConsumableResetResult {
+    readonly key: DreameConsumableKey;
+    readonly actionResult: unknown;
+    readonly refreshedFrom: ConsumableRefreshSource | null;
+    readonly leftPct: number | null;
+    readonly timeLeft: ConsumableTimeLeft | null;
+    readonly refreshError: Error | null;
+}
 
 /**
  * Per-model vacuum capability records (ported from malard/node-dreame
@@ -1894,18 +1941,33 @@ declare class VacuumDevice extends BaseDevice<VacuumDeviceEvents> {
      */
     get supportedConsumables(): readonly ConsumableReading[];
     /**
-     * Seed EVERY consumable life property from the cloud shadow (no robot wake) so
-     * {@link supportedConsumables} reflects the full set on a docked robot. The
-     * consumable life values are static settings the robot rarely re-pushes over
-     * MQTT, so a fresh connect surfaces only the actively-changing ones without this.
+     * Time left before a consumable needs attention, in the unit the robot counts
+     * it in (see {@link ConsumableSpec.timeLeft}), or `null` when the model does
+     * not report it or the key has no time-left twin.
+     */
+    consumableTimeLeft(key: DreameConsumableKey): ConsumableTimeLeft | null;
+    /**
+     * Seed EVERY consumable life property AND its time-left twin from the cloud
+     * shadow (no robot wake), in one call, so {@link supportedConsumables} and
+     * {@link consumableTimeLeft} reflect the full set on a docked robot. The
+     * robot rarely re-pushes these over MQTT, so a consumer that wants them fresh
+     * must call this again — the library does not poll them.
      */
     refreshConsumables(): Promise<void>;
     /**
      * Reset (mark replaced → life back to 100%) one consumable via its MIoT reset
-     * action. Rejects when the model exposes no reset action for the key (e.g.
-     * `dust-bag`) or the key is unknown.
+     * action, then re-read that consumable's life % and time left ONCE so the
+     * cache — and every getter after this resolves — reflects the reset. The
+     * re-read is live; if the robot does not answer it falls back to the cloud
+     * shadow (which may still hold the pre-reset value until the robot reports),
+     * and `refreshedFrom` says which one answered.
+     *
+     * Rejects when the model exposes no reset action for the key (e.g.
+     * `dust-bag`), the key is unknown, or the action itself fails. A failed
+     * RE-READ does not reject: the reset happened, and the result says the values
+     * are unknown (`refreshedFrom: null`).
      */
-    resetConsumable(key: DreameConsumableKey): Promise<unknown>;
+    resetConsumable(key: DreameConsumableKey): Promise<ConsumableResetResult>;
     /**
      * The raw `AI_DETECTION` value (siid 4 piid 22) — an int bitmask or a JSON
      * string, depending on firmware — or `null` when not yet observed. Prefer the
@@ -2993,15 +3055,15 @@ declare const DeviceDumpSchema: z.ZodObject<{
         generatedAt: number;
     }>;
 }, "strip", z.ZodTypeAny, {
-    schemaVersion: 1;
-    library: "nodedreame" | "nodewitt";
-    libraryVersion: string;
     device: {
         model: string;
         region?: string | undefined;
         type?: string | undefined;
         firmware?: string | undefined;
     };
+    schemaVersion: 1;
+    library: "nodedreame" | "nodewitt";
+    libraryVersion: string;
     observations: {
         properties: Record<string, {
             values: (string | number | boolean)[];
@@ -3040,15 +3102,15 @@ declare const DeviceDumpSchema: z.ZodObject<{
         generatedAt: number;
     };
 }, {
-    schemaVersion: 1;
-    library: "nodedreame" | "nodewitt";
-    libraryVersion: string;
     device: {
         model: string;
         region?: string | undefined;
         type?: string | undefined;
         firmware?: string | undefined;
     };
+    schemaVersion: 1;
+    library: "nodedreame" | "nodewitt";
+    libraryVersion: string;
     observations: {
         properties: Record<string, {
             values: (string | number | boolean)[];
@@ -3841,4 +3903,4 @@ interface ListDevicesInput {
 /** Enumerate the devices visible to the authenticated account (incl. shared). */
 declare function listDevices(input: ListDevicesInput): Promise<DreameDevice[]>;
 
-export { AI_FEATURE_BIT, AI_FEATURE_JSON_KEY, ALIYUN_REGION_ID, AUTO_SWITCH_JSON_KEY, type AacConfig, type AiDetectionRaw, type AudioInfoEvent, type AutoSwitchKey, type AutoSwitchRaw, type AvcConfig, BaseDevice, type BaseDeviceEvents, type BatchDeviceDataFetcher, type BrokerEndpoint, type CameraStreamHandle, type CapabilityResolver, ChargingStatus, type CleanOpts, CleaningMode, type ConsumableReading, type ConsumableSpec, type CreateDeviceArgs, DRIVE_DIRECTIONS, DefaultCapabilityResolver, type DetectionBox, type DeviceCapabilities, type DeviceConnectivity, type DeviceDump, type DeviceEvent, type DeviceVideoProfile, type DreameAiFeature, DreameApiError, DreameAuthError, DreameCameraController, type DreameCameraControllerInput, DreameCameraStream, type DreameCameraStreamEvents, type DreameCameraStreamInput, type DreameCloudState, type DreameConsumableKey, type DreameDevice, DreameDeviceOfflineError, DreameError, type DreameRegion, type DreameSession, DreameTransportError, DreameVideoSession, type DreameVideoSessionInput, type DriveDirection, type DumperOptions, type FrameSource, type FrameSourceFactory, type IotSession, LIBRARY_NAME, LV_STATUS, type ListDevicesInput, LvRtmpClient, type LvRtmpClientOptions, MONITOR_AIID, MONITOR_PIID, MONITOR_SIID, MONITOR_VENDOR_TOKEN, MODEL_CAPABILITIES as MOWER_MODEL_CAPABILITIES, MOWER_TASK_SUBSTATES, type MapBoundingBox, type MapCleanedAreaOverlay, type MapColorScheme, type MapDimensions, type MapFrameType, type MapLayer, type MapLayerType, type MapLowLyingArea, type MapObstacle, type MapPath, type MapPathType, type MapPoint, type MapPose, type MapRestrictedArea, type MapRoom, type MapRoomWall, type MapRun, type MapSegment, type MapStorey, type MapVirtualWall, type MapWallsInfo, type MiotAction, MiotError, type MiotProp, MiotState, type MonitorActionCaller, type MowerAvailableMap, type MowerCapabilities, MowerCapabilityResolver, MowerChargingStatus, type MowerConsumableKey, type MowerConsumableReading, type MowerContour, MowerControlAction, type MowerControlState, MowerDevice, type MowerDeviceInput, MowerFault, type MowerFaultSeverity, type MowerHeartbeat, type MowerMap, type MowerMapBoundary, type MowerMowPath, type MowerMowingProgress, type MowerPathEntry, type MowerPoint, type MowerSpotArea, MowerStatus, type MowerTaskDescriptor, MowerTaskStatus, type MowerTaskSubState, type MowerZone, Nodreame, type NodreameDeps, type NodreameEvents, type NodreameOptions, type OaSession, type ObstacleDetection, type OssFetchInput, type OssFetcherLike, PET_SOUNDS, type PersonFollowDetection, type PetSound, type PropertyChangedEvent, type PropertyResult, type PropertyState, type PropertyWrite, type RelayMinter, type RenderMowerSvgOptions, type RenderVacuumPngOptions, type RenderWifiSignalPngOptions, type StateChangedEvent, type StatusEvent, type StreamInfo, type StreamQueryInput, SuctionLevel, TALK_AUDIO_HEADER_G711A, TaskStatus, VACUUM_ACTIONS, VACUUM_CONSUMABLES, MODEL_CAPABILITIES$1 as VACUUM_MODEL_CAPABILITIES, VACUUM_MOVE, VACUUM_SIID, type VacuumActionKey, type VacuumCapabilities, VacuumCapabilityResolver, VacuumDevice, type VacuumGetMapInput, type VacuumMap, type VideoAccessToken, type VideoAccessUnitEvent, type VideoRequestInput, type VideoVendor, WaterVolume, type WifiSignalMap, type WifiSignalMapInput, aacSampleRate, aacToAdts, avccToAnnexB, consumableSpec, createClientDumper, createDumper, createIotSession, decodeAiFeature, decodeAutoSwitch, decodeAutoSwitchAll, decodeWifiSignalMap, encodeAiFeatureWrite, encodeAutoSwitchWrite, explainNoCameraChannel, extractMowerConsumableValues, getAliyunAuthCode, getDeviceVideoProfile, getMowerCapabilities, getTencentIdentity, getTencentP2PInfo, getVacuumCapabilities, getVideoAccessToken, getVideoFamilyId, hashAccessCode, isAuthRefusedError, isDreameConsumableKey, listDevices, loginByOauth, makeMonitorSession, mowerConsumableIndex, mowerFaultSeverity, parseAacConfig, parseAvcConfig, parseConnectivity, parseMowerConsumables, parseMowerHeartbeat, parseMowingProgress, parseObstacleData, parsePersonFollow, parseRelayUrl, pcm16ToALaw, pcm16leToALaw, remoteDriveValue, renderMowerSvg, renderVacuumPng, renderWifiSignalPng, resolveCapabilities, signApiGatewayRequest, streamQuery, supportedAutoSwitchKeys, toVideoProfile };
+export { AI_FEATURE_BIT, AI_FEATURE_JSON_KEY, ALIYUN_REGION_ID, AUTO_SWITCH_JSON_KEY, type AacConfig, type AiDetectionRaw, type AudioInfoEvent, type AutoSwitchKey, type AutoSwitchRaw, type AvcConfig, BaseDevice, type BaseDeviceEvents, type BatchDeviceDataFetcher, type BrokerEndpoint, type CameraStreamHandle, type CapabilityResolver, ChargingStatus, type CleanOpts, CleaningMode, type ConsumableReading, type ConsumableRefreshSource, type ConsumableResetResult, type ConsumableSpec, type ConsumableTimeLeft, type ConsumableTimeLeftSpec, type ConsumableTimeLeftUnit, type CreateDeviceArgs, DRIVE_DIRECTIONS, DefaultCapabilityResolver, type DetectionBox, type DeviceCapabilities, type DeviceConnectivity, type DeviceDump, type DeviceEvent, type DeviceVideoProfile, type DreameAiFeature, DreameApiError, DreameAuthError, DreameCameraController, type DreameCameraControllerInput, DreameCameraStream, type DreameCameraStreamEvents, type DreameCameraStreamInput, type DreameCloudState, type DreameConsumableKey, type DreameDevice, DreameDeviceOfflineError, DreameError, type DreameRegion, type DreameSession, DreameTransportError, DreameVideoSession, type DreameVideoSessionInput, type DriveDirection, type DumperOptions, type FrameSource, type FrameSourceFactory, type IotSession, LIBRARY_NAME, LV_STATUS, type ListDevicesInput, LvRtmpClient, type LvRtmpClientOptions, MONITOR_AIID, MONITOR_PIID, MONITOR_SIID, MONITOR_VENDOR_TOKEN, MODEL_CAPABILITIES as MOWER_MODEL_CAPABILITIES, MOWER_TASK_SUBSTATES, type MapBoundingBox, type MapCleanedAreaOverlay, type MapColorScheme, type MapDimensions, type MapFrameType, type MapLayer, type MapLayerType, type MapLowLyingArea, type MapObstacle, type MapPath, type MapPathType, type MapPoint, type MapPose, type MapRestrictedArea, type MapRoom, type MapRoomWall, type MapRun, type MapSegment, type MapStorey, type MapVirtualWall, type MapWallsInfo, type MiotAction, MiotError, type MiotProp, MiotState, type MonitorActionCaller, type MowerAvailableMap, type MowerCapabilities, MowerCapabilityResolver, MowerChargingStatus, type MowerConsumableKey, type MowerConsumableReading, type MowerContour, MowerControlAction, type MowerControlState, MowerDevice, type MowerDeviceInput, MowerFault, type MowerFaultSeverity, type MowerHeartbeat, type MowerMap, type MowerMapBoundary, type MowerMowPath, type MowerMowingProgress, type MowerPathEntry, type MowerPoint, type MowerSpotArea, MowerStatus, type MowerTaskDescriptor, MowerTaskStatus, type MowerTaskSubState, type MowerZone, Nodreame, type NodreameDeps, type NodreameEvents, type NodreameOptions, type OaSession, type ObstacleDetection, type OssFetchInput, type OssFetcherLike, PET_SOUNDS, type PersonFollowDetection, type PetSound, type PropertyChangedEvent, type PropertyResult, type PropertyState, type PropertyWrite, type RelayMinter, type RenderMowerSvgOptions, type RenderVacuumPngOptions, type RenderWifiSignalPngOptions, type StateChangedEvent, type StatusEvent, type StreamInfo, type StreamQueryInput, SuctionLevel, TALK_AUDIO_HEADER_G711A, TaskStatus, VACUUM_ACTIONS, VACUUM_CONSUMABLES, MODEL_CAPABILITIES$1 as VACUUM_MODEL_CAPABILITIES, VACUUM_MOVE, VACUUM_SIID, type VacuumActionKey, type VacuumCapabilities, VacuumCapabilityResolver, VacuumDevice, type VacuumGetMapInput, type VacuumMap, type VideoAccessToken, type VideoAccessUnitEvent, type VideoRequestInput, type VideoVendor, WaterVolume, type WifiSignalMap, type WifiSignalMapInput, aacSampleRate, aacToAdts, avccToAnnexB, consumableSpec, createClientDumper, createDumper, createIotSession, decodeAiFeature, decodeAutoSwitch, decodeAutoSwitchAll, decodeWifiSignalMap, encodeAiFeatureWrite, encodeAutoSwitchWrite, explainNoCameraChannel, extractMowerConsumableValues, getAliyunAuthCode, getDeviceVideoProfile, getMowerCapabilities, getTencentIdentity, getTencentP2PInfo, getVacuumCapabilities, getVideoAccessToken, getVideoFamilyId, hashAccessCode, isAuthRefusedError, isDreameConsumableKey, listDevices, loginByOauth, makeMonitorSession, mowerConsumableIndex, mowerFaultSeverity, parseAacConfig, parseAvcConfig, parseConnectivity, parseMowerConsumables, parseMowerHeartbeat, parseMowingProgress, parseObstacleData, parsePersonFollow, parseRelayUrl, pcm16ToALaw, pcm16leToALaw, remoteDriveValue, renderMowerSvg, renderVacuumPng, renderWifiSignalPng, resolveCapabilities, signApiGatewayRequest, streamQuery, supportedAutoSwitchKeys, toVideoProfile };

package/dist/index.d.ts

@@ -892,6 +892,19 @@ declare function encodeAutoSwitchWrite(key: AutoSwitchKey, value: number): strin
  */
 /** Stable consumable keys (kebab-case so a consumer can use them verbatim). */
 type DreameConsumableKey = 'main-brush' | 'side-brush' | 'filter' | 'sensor' | 'tank-filter' | 'mop-pad' | 'silver-ion' | 'detergent' | 'squeegee' | 'deodorizer' | 'wheel' | 'scale-inhibitor' | 'dust-bag';
+/** The unit a consumable's time-left property counts in. */
+type ConsumableTimeLeftUnit = 'hours' | 'days';
+/** A consumable's time-left property: where it lives and what it counts in. */
+interface ConsumableTimeLeftSpec {
+    readonly siid: number;
+    readonly piid: number;
+    readonly unit: ConsumableTimeLeftUnit;
+}
+/** A consumable's time left as the robot reports it. */
+interface ConsumableTimeLeft {
+    readonly value: number;
+    readonly unit: ConsumableTimeLeftUnit;
+}
 /** One consumable's wire coordinates: remaining-life property + optional reset action. */
 interface ConsumableSpec {
     readonly key: DreameConsumableKey;
@@ -901,6 +914,11 @@ interface ConsumableSpec {
         readonly siid: number;
         readonly piid: number;
     };
+    /**
+     * The time-left twin on the same service (the other piid), or null when the
+     * consumable has none. A reset rewrites it together with {@link life}.
+     */
+    readonly timeLeft: ConsumableTimeLeftSpec | null;
     /** "Mark replaced / reset life" action, or null when the model exposes none. */
     readonly reset: {
         readonly siid: number;
@@ -910,7 +928,18 @@ interface ConsumableSpec {
 /**
  * Every consumable nodedreame knows. The reset action shares the consumable's
  * service `siid` with `aiid 1` (Tasshack action map). `dust-bag` has a life
- * property but no reset action.
+ * property but no reset action and no time-left twin.
+ *
+ * Time-left twins: the service's other piid. Measured against the Dreame app on
+ * an r2538z on 2026-09-26 ("Tempo residuo"): main brush 9/1 = 271 h at 90 %,
+ * side brush 10/1 = 171 h at 85 %, filter 11/2 = 121 h at 80 %, sensors 16/2 =
+ * 1 h at 4 % — each consistent with its life (300/200/150/30 h). Wheel 30/1 and
+ * scale inhibitor 31/1 count DAYS (HA units for that robot). The rest are the
+ * mapping the camstack Dreame addon already shipped; not measured on a robot
+ * that reports them.
+ *
+ * Labels `Sensor Dirty` / `Wheel Dirty` are the maintenance the app and HA name
+ * (clean the sensors / wheels) — a bare "Sensor at 4 %" read as a broken part.
  */
 declare const VACUUM_CONSUMABLES: readonly ConsumableSpec[];
 /** Lookup a consumable spec by key (undefined for an unknown key). */
@@ -927,6 +956,24 @@ interface ConsumableReading {
     readonly leftPct: number;
     readonly resettable: boolean;
 }
+/** Where a post-reset re-read came from: the robot itself, or the cloud shadow. */
+type ConsumableRefreshSource = 'device' | 'cloud-shadow';
+/**
+ * The outcome of a consumable reset. The action has SUCCEEDED whenever this
+ * resolves; `refreshedFrom` says whether the values after it were re-read.
+ * `null` there means both reads failed — `leftPct`/`timeLeft` are then `null`
+ * (unknown, not zero) and the cache still holds the pre-reset values.
+ * `refreshError` is why the better source was not used: the live read's error
+ * when the shadow answered, the shadow's when neither did, else `null`.
+ */
+interface ConsumableResetResult {
+    readonly key: DreameConsumableKey;
+    readonly actionResult: unknown;
+    readonly refreshedFrom: ConsumableRefreshSource | null;
+    readonly leftPct: number | null;
+    readonly timeLeft: ConsumableTimeLeft | null;
+    readonly refreshError: Error | null;
+}
 
 /**
  * Per-model vacuum capability records (ported from malard/node-dreame
@@ -1894,18 +1941,33 @@ declare class VacuumDevice extends BaseDevice<VacuumDeviceEvents> {
      */
     get supportedConsumables(): readonly ConsumableReading[];
     /**
-     * Seed EVERY consumable life property from the cloud shadow (no robot wake) so
-     * {@link supportedConsumables} reflects the full set on a docked robot. The
-     * consumable life values are static settings the robot rarely re-pushes over
-     * MQTT, so a fresh connect surfaces only the actively-changing ones without this.
+     * Time left before a consumable needs attention, in the unit the robot counts
+     * it in (see {@link ConsumableSpec.timeLeft}), or `null` when the model does
+     * not report it or the key has no time-left twin.
+     */
+    consumableTimeLeft(key: DreameConsumableKey): ConsumableTimeLeft | null;
+    /**
+     * Seed EVERY consumable life property AND its time-left twin from the cloud
+     * shadow (no robot wake), in one call, so {@link supportedConsumables} and
+     * {@link consumableTimeLeft} reflect the full set on a docked robot. The
+     * robot rarely re-pushes these over MQTT, so a consumer that wants them fresh
+     * must call this again — the library does not poll them.
      */
     refreshConsumables(): Promise<void>;
     /**
      * Reset (mark replaced → life back to 100%) one consumable via its MIoT reset
-     * action. Rejects when the model exposes no reset action for the key (e.g.
-     * `dust-bag`) or the key is unknown.
+     * action, then re-read that consumable's life % and time left ONCE so the
+     * cache — and every getter after this resolves — reflects the reset. The
+     * re-read is live; if the robot does not answer it falls back to the cloud
+     * shadow (which may still hold the pre-reset value until the robot reports),
+     * and `refreshedFrom` says which one answered.
+     *
+     * Rejects when the model exposes no reset action for the key (e.g.
+     * `dust-bag`), the key is unknown, or the action itself fails. A failed
+     * RE-READ does not reject: the reset happened, and the result says the values
+     * are unknown (`refreshedFrom: null`).
      */
-    resetConsumable(key: DreameConsumableKey): Promise<unknown>;
+    resetConsumable(key: DreameConsumableKey): Promise<ConsumableResetResult>;
     /**
      * The raw `AI_DETECTION` value (siid 4 piid 22) — an int bitmask or a JSON
      * string, depending on firmware — or `null` when not yet observed. Prefer the
@@ -2993,15 +3055,15 @@ declare const DeviceDumpSchema: z.ZodObject<{
         generatedAt: number;
     }>;
 }, "strip", z.ZodTypeAny, {
-    schemaVersion: 1;
-    library: "nodedreame" | "nodewitt";
-    libraryVersion: string;
     device: {
         model: string;
         region?: string | undefined;
         type?: string | undefined;
         firmware?: string | undefined;
     };
+    schemaVersion: 1;
+    library: "nodedreame" | "nodewitt";
+    libraryVersion: string;
     observations: {
         properties: Record<string, {
             values: (string | number | boolean)[];
@@ -3040,15 +3102,15 @@ declare const DeviceDumpSchema: z.ZodObject<{
         generatedAt: number;
     };
 }, {
-    schemaVersion: 1;
-    library: "nodedreame" | "nodewitt";
-    libraryVersion: string;
     device: {
         model: string;
         region?: string | undefined;
         type?: string | undefined;
         firmware?: string | undefined;
     };
+    schemaVersion: 1;
+    library: "nodedreame" | "nodewitt";
+    libraryVersion: string;
     observations: {
         properties: Record<string, {
             values: (string | number | boolean)[];
@@ -3841,4 +3903,4 @@ interface ListDevicesInput {
 /** Enumerate the devices visible to the authenticated account (incl. shared). */
 declare function listDevices(input: ListDevicesInput): Promise<DreameDevice[]>;
 
-export { AI_FEATURE_BIT, AI_FEATURE_JSON_KEY, ALIYUN_REGION_ID, AUTO_SWITCH_JSON_KEY, type AacConfig, type AiDetectionRaw, type AudioInfoEvent, type AutoSwitchKey, type AutoSwitchRaw, type AvcConfig, BaseDevice, type BaseDeviceEvents, type BatchDeviceDataFetcher, type BrokerEndpoint, type CameraStreamHandle, type CapabilityResolver, ChargingStatus, type CleanOpts, CleaningMode, type ConsumableReading, type ConsumableSpec, type CreateDeviceArgs, DRIVE_DIRECTIONS, DefaultCapabilityResolver, type DetectionBox, type DeviceCapabilities, type DeviceConnectivity, type DeviceDump, type DeviceEvent, type DeviceVideoProfile, type DreameAiFeature, DreameApiError, DreameAuthError, DreameCameraController, type DreameCameraControllerInput, DreameCameraStream, type DreameCameraStreamEvents, type DreameCameraStreamInput, type DreameCloudState, type DreameConsumableKey, type DreameDevice, DreameDeviceOfflineError, DreameError, type DreameRegion, type DreameSession, DreameTransportError, DreameVideoSession, type DreameVideoSessionInput, type DriveDirection, type DumperOptions, type FrameSource, type FrameSourceFactory, type IotSession, LIBRARY_NAME, LV_STATUS, type ListDevicesInput, LvRtmpClient, type LvRtmpClientOptions, MONITOR_AIID, MONITOR_PIID, MONITOR_SIID, MONITOR_VENDOR_TOKEN, MODEL_CAPABILITIES as MOWER_MODEL_CAPABILITIES, MOWER_TASK_SUBSTATES, type MapBoundingBox, type MapCleanedAreaOverlay, type MapColorScheme, type MapDimensions, type MapFrameType, type MapLayer, type MapLayerType, type MapLowLyingArea, type MapObstacle, type MapPath, type MapPathType, type MapPoint, type MapPose, type MapRestrictedArea, type MapRoom, type MapRoomWall, type MapRun, type MapSegment, type MapStorey, type MapVirtualWall, type MapWallsInfo, type MiotAction, MiotError, type MiotProp, MiotState, type MonitorActionCaller, type MowerAvailableMap, type MowerCapabilities, MowerCapabilityResolver, MowerChargingStatus, type MowerConsumableKey, type MowerConsumableReading, type MowerContour, MowerControlAction, type MowerControlState, MowerDevice, type MowerDeviceInput, MowerFault, type MowerFaultSeverity, type MowerHeartbeat, type MowerMap, type MowerMapBoundary, type MowerMowPath, type MowerMowingProgress, type MowerPathEntry, type MowerPoint, type MowerSpotArea, MowerStatus, type MowerTaskDescriptor, MowerTaskStatus, type MowerTaskSubState, type MowerZone, Nodreame, type NodreameDeps, type NodreameEvents, type NodreameOptions, type OaSession, type ObstacleDetection, type OssFetchInput, type OssFetcherLike, PET_SOUNDS, type PersonFollowDetection, type PetSound, type PropertyChangedEvent, type PropertyResult, type PropertyState, type PropertyWrite, type RelayMinter, type RenderMowerSvgOptions, type RenderVacuumPngOptions, type RenderWifiSignalPngOptions, type StateChangedEvent, type StatusEvent, type StreamInfo, type StreamQueryInput, SuctionLevel, TALK_AUDIO_HEADER_G711A, TaskStatus, VACUUM_ACTIONS, VACUUM_CONSUMABLES, MODEL_CAPABILITIES$1 as VACUUM_MODEL_CAPABILITIES, VACUUM_MOVE, VACUUM_SIID, type VacuumActionKey, type VacuumCapabilities, VacuumCapabilityResolver, VacuumDevice, type VacuumGetMapInput, type VacuumMap, type VideoAccessToken, type VideoAccessUnitEvent, type VideoRequestInput, type VideoVendor, WaterVolume, type WifiSignalMap, type WifiSignalMapInput, aacSampleRate, aacToAdts, avccToAnnexB, consumableSpec, createClientDumper, createDumper, createIotSession, decodeAiFeature, decodeAutoSwitch, decodeAutoSwitchAll, decodeWifiSignalMap, encodeAiFeatureWrite, encodeAutoSwitchWrite, explainNoCameraChannel, extractMowerConsumableValues, getAliyunAuthCode, getDeviceVideoProfile, getMowerCapabilities, getTencentIdentity, getTencentP2PInfo, getVacuumCapabilities, getVideoAccessToken, getVideoFamilyId, hashAccessCode, isAuthRefusedError, isDreameConsumableKey, listDevices, loginByOauth, makeMonitorSession, mowerConsumableIndex, mowerFaultSeverity, parseAacConfig, parseAvcConfig, parseConnectivity, parseMowerConsumables, parseMowerHeartbeat, parseMowingProgress, parseObstacleData, parsePersonFollow, parseRelayUrl, pcm16ToALaw, pcm16leToALaw, remoteDriveValue, renderMowerSvg, renderVacuumPng, renderWifiSignalPng, resolveCapabilities, signApiGatewayRequest, streamQuery, supportedAutoSwitchKeys, toVideoProfile };
+export { AI_FEATURE_BIT, AI_FEATURE_JSON_KEY, ALIYUN_REGION_ID, AUTO_SWITCH_JSON_KEY, type AacConfig, type AiDetectionRaw, type AudioInfoEvent, type AutoSwitchKey, type AutoSwitchRaw, type AvcConfig, BaseDevice, type BaseDeviceEvents, type BatchDeviceDataFetcher, type BrokerEndpoint, type CameraStreamHandle, type CapabilityResolver, ChargingStatus, type CleanOpts, CleaningMode, type ConsumableReading, type ConsumableRefreshSource, type ConsumableResetResult, type ConsumableSpec, type ConsumableTimeLeft, type ConsumableTimeLeftSpec, type ConsumableTimeLeftUnit, type CreateDeviceArgs, DRIVE_DIRECTIONS, DefaultCapabilityResolver, type DetectionBox, type DeviceCapabilities, type DeviceConnectivity, type DeviceDump, type DeviceEvent, type DeviceVideoProfile, type DreameAiFeature, DreameApiError, DreameAuthError, DreameCameraController, type DreameCameraControllerInput, DreameCameraStream, type DreameCameraStreamEvents, type DreameCameraStreamInput, type DreameCloudState, type DreameConsumableKey, type DreameDevice, DreameDeviceOfflineError, DreameError, type DreameRegion, type DreameSession, DreameTransportError, DreameVideoSession, type DreameVideoSessionInput, type DriveDirection, type DumperOptions, type FrameSource, type FrameSourceFactory, type IotSession, LIBRARY_NAME, LV_STATUS, type ListDevicesInput, LvRtmpClient, type LvRtmpClientOptions, MONITOR_AIID, MONITOR_PIID, MONITOR_SIID, MONITOR_VENDOR_TOKEN, MODEL_CAPABILITIES as MOWER_MODEL_CAPABILITIES, MOWER_TASK_SUBSTATES, type MapBoundingBox, type MapCleanedAreaOverlay, type MapColorScheme, type MapDimensions, type MapFrameType, type MapLayer, type MapLayerType, type MapLowLyingArea, type MapObstacle, type MapPath, type MapPathType, type MapPoint, type MapPose, type MapRestrictedArea, type MapRoom, type MapRoomWall, type MapRun, type MapSegment, type MapStorey, type MapVirtualWall, type MapWallsInfo, type MiotAction, MiotError, type MiotProp, MiotState, type MonitorActionCaller, type MowerAvailableMap, type MowerCapabilities, MowerCapabilityResolver, MowerChargingStatus, type MowerConsumableKey, type MowerConsumableReading, type MowerContour, MowerControlAction, type MowerControlState, MowerDevice, type MowerDeviceInput, MowerFault, type MowerFaultSeverity, type MowerHeartbeat, type MowerMap, type MowerMapBoundary, type MowerMowPath, type MowerMowingProgress, type MowerPathEntry, type MowerPoint, type MowerSpotArea, MowerStatus, type MowerTaskDescriptor, MowerTaskStatus, type MowerTaskSubState, type MowerZone, Nodreame, type NodreameDeps, type NodreameEvents, type NodreameOptions, type OaSession, type ObstacleDetection, type OssFetchInput, type OssFetcherLike, PET_SOUNDS, type PersonFollowDetection, type PetSound, type PropertyChangedEvent, type PropertyResult, type PropertyState, type PropertyWrite, type RelayMinter, type RenderMowerSvgOptions, type RenderVacuumPngOptions, type RenderWifiSignalPngOptions, type StateChangedEvent, type StatusEvent, type StreamInfo, type StreamQueryInput, SuctionLevel, TALK_AUDIO_HEADER_G711A, TaskStatus, VACUUM_ACTIONS, VACUUM_CONSUMABLES, MODEL_CAPABILITIES$1 as VACUUM_MODEL_CAPABILITIES, VACUUM_MOVE, VACUUM_SIID, type VacuumActionKey, type VacuumCapabilities, VacuumCapabilityResolver, VacuumDevice, type VacuumGetMapInput, type VacuumMap, type VideoAccessToken, type VideoAccessUnitEvent, type VideoRequestInput, type VideoVendor, WaterVolume, type WifiSignalMap, type WifiSignalMapInput, aacSampleRate, aacToAdts, avccToAnnexB, consumableSpec, createClientDumper, createDumper, createIotSession, decodeAiFeature, decodeAutoSwitch, decodeAutoSwitchAll, decodeWifiSignalMap, encodeAiFeatureWrite, encodeAutoSwitchWrite, explainNoCameraChannel, extractMowerConsumableValues, getAliyunAuthCode, getDeviceVideoProfile, getMowerCapabilities, getTencentIdentity, getTencentP2PInfo, getVacuumCapabilities, getVideoAccessToken, getVideoFamilyId, hashAccessCode, isAuthRefusedError, isDreameConsumableKey, listDevices, loginByOauth, makeMonitorSession, mowerConsumableIndex, mowerFaultSeverity, parseAacConfig, parseAvcConfig, parseConnectivity, parseMowerConsumables, parseMowerHeartbeat, parseMowingProgress, parseObstacleData, parsePersonFollow, parseRelayUrl, pcm16ToALaw, pcm16leToALaw, remoteDriveValue, renderMowerSvg, renderVacuumPng, renderWifiSignalPng, resolveCapabilities, signApiGatewayRequest, streamQuery, supportedAutoSwitchKeys, toVideoProfile };

package/dist/index.js

@@ -1,6 +1,6 @@
 // src/support/version.ts
 var LIBRARY_NAME = "nodedreame";
-var LIBRARY_VERSION = "1.12.4";
+var LIBRARY_VERSION = "1.12.5";
 
 // src/transport/errors.ts
 var DreameError = class extends Error {
@@ -1846,50 +1846,93 @@ var VACUUM_CONSUMABLES = [
     key: "main-brush",
     label: "Main Brush",
     life: { siid: 9, piid: 2 },
+    timeLeft: { siid: 9, piid: 1, unit: "hours" },
     reset: { siid: 9, aiid: 1 }
   },
   {
     key: "side-brush",
     label: "Side Brush",
     life: { siid: 10, piid: 2 },
+    timeLeft: { siid: 10, piid: 1, unit: "hours" },
     reset: { siid: 10, aiid: 1 }
   },
-  { key: "filter", label: "Filter", life: { siid: 11, piid: 1 }, reset: { siid: 11, aiid: 1 } },
-  { key: "sensor", label: "Sensor", life: { siid: 16, piid: 1 }, reset: { siid: 16, aiid: 1 } },
+  {
+    key: "filter",
+    label: "Filter",
+    life: { siid: 11, piid: 1 },
+    timeLeft: { siid: 11, piid: 2, unit: "hours" },
+    reset: { siid: 11, aiid: 1 }
+  },
+  {
+    key: "sensor",
+    label: "Sensor Dirty",
+    life: { siid: 16, piid: 1 },
+    timeLeft: { siid: 16, piid: 2, unit: "hours" },
+    reset: { siid: 16, aiid: 1 }
+  },
   {
     key: "tank-filter",
     label: "Tank Filter",
     life: { siid: 17, piid: 1 },
+    timeLeft: { siid: 17, piid: 2, unit: "hours" },
     reset: { siid: 17, aiid: 1 }
   },
-  { key: "mop-pad", label: "Mop Pad", life: { siid: 18, piid: 1 }, reset: { siid: 18, aiid: 1 } },
+  {
+    key: "mop-pad",
+    label: "Mop Pad",
+    life: { siid: 18, piid: 1 },
+    timeLeft: { siid: 18, piid: 2, unit: "hours" },
+    reset: { siid: 18, aiid: 1 }
+  },
   {
     key: "silver-ion",
     label: "Silver-ion",
     life: { siid: 19, piid: 2 },
+    timeLeft: { siid: 19, piid: 1, unit: "days" },
     reset: { siid: 19, aiid: 1 }
   },
   {
     key: "detergent",
     label: "Detergent",
     life: { siid: 20, piid: 1 },
+    timeLeft: { siid: 20, piid: 2, unit: "days" },
     reset: { siid: 20, aiid: 1 }
   },
-  { key: "squeegee", label: "Squeegee", life: { siid: 24, piid: 1 }, reset: { siid: 24, aiid: 1 } },
+  {
+    key: "squeegee",
+    label: "Squeegee",
+    life: { siid: 24, piid: 1 },
+    timeLeft: { siid: 24, piid: 2, unit: "days" },
+    reset: { siid: 24, aiid: 1 }
+  },
   {
     key: "deodorizer",
     label: "Deodorizer",
     life: { siid: 29, piid: 2 },
+    timeLeft: { siid: 29, piid: 1, unit: "days" },
     reset: { siid: 29, aiid: 1 }
   },
-  { key: "wheel", label: "Wheel", life: { siid: 30, piid: 2 }, reset: { siid: 30, aiid: 1 } },
+  {
+    key: "wheel",
+    label: "Wheel Dirty",
+    life: { siid: 30, piid: 2 },
+    timeLeft: { siid: 30, piid: 1, unit: "days" },
+    reset: { siid: 30, aiid: 1 }
+  },
   {
     key: "scale-inhibitor",
     label: "Scale Inhibitor",
     life: { siid: 31, piid: 2 },
+    timeLeft: { siid: 31, piid: 1, unit: "days" },
     reset: { siid: 31, aiid: 1 }
   },
-  { key: "dust-bag", label: "Dust Bag", life: { siid: 27, piid: 17 }, reset: null }
+  {
+    key: "dust-bag",
+    label: "Dust Bag",
+    life: { siid: 27, piid: 17 },
+    timeLeft: null,
+    reset: null
+  }
 ];
 function consumableSpec(key2) {
   return VACUUM_CONSUMABLES.find((c) => c.key === key2);
@@ -4761,6 +4804,12 @@ var OssFetcher = class {
 };
 
 // src/models/vacuum/vacuum-device.ts
+function consumableProps(spec) {
+  return spec.timeLeft === null ? [spec.life] : [spec.life, { siid: spec.timeLeft.siid, piid: spec.timeLeft.piid }];
+}
+function asError(err) {
+  return err instanceof Error ? err : new Error(String(err));
+}
 var SUCTION = enumLookup([
   0 /* Quiet */,
   1 /* Standard */,
@@ -4918,25 +4967,72 @@ var VacuumDevice = class _VacuumDevice extends BaseDevice {
     });
   }
   /**
-   * Seed EVERY consumable life property from the cloud shadow (no robot wake) so
-   * {@link supportedConsumables} reflects the full set on a docked robot. The
-   * consumable life values are static settings the robot rarely re-pushes over
-   * MQTT, so a fresh connect surfaces only the actively-changing ones without this.
+   * Time left before a consumable needs attention, in the unit the robot counts
+   * it in (see {@link ConsumableSpec.timeLeft}), or `null` when the model does
+   * not report it or the key has no time-left twin.
+   */
+  consumableTimeLeft(key2) {
+    const spec = consumableSpec(key2);
+    if (spec === void 0 || spec.timeLeft === null) return null;
+    const value = this.#num(spec.timeLeft.siid, spec.timeLeft.piid);
+    return value === null ? null : { value, unit: spec.timeLeft.unit };
+  }
+  /**
+   * Seed EVERY consumable life property AND its time-left twin from the cloud
+   * shadow (no robot wake), in one call, so {@link supportedConsumables} and
+   * {@link consumableTimeLeft} reflect the full set on a docked robot. The
+   * robot rarely re-pushes these over MQTT, so a consumer that wants them fresh
+   * must call this again — the library does not poll them.
    */
   async refreshConsumables() {
-    await this.refreshCachedProperties(VACUUM_CONSUMABLES.map((c) => c.life));
+    await this.refreshCachedProperties(VACUUM_CONSUMABLES.flatMap(consumableProps));
   }
   /**
    * Reset (mark replaced → life back to 100%) one consumable via its MIoT reset
-   * action. Rejects when the model exposes no reset action for the key (e.g.
-   * `dust-bag`) or the key is unknown.
+   * action, then re-read that consumable's life % and time left ONCE so the
+   * cache — and every getter after this resolves — reflects the reset. The
+   * re-read is live; if the robot does not answer it falls back to the cloud
+   * shadow (which may still hold the pre-reset value until the robot reports),
+   * and `refreshedFrom` says which one answered.
+   *
+   * Rejects when the model exposes no reset action for the key (e.g.
+   * `dust-bag`), the key is unknown, or the action itself fails. A failed
+   * RE-READ does not reject: the reset happened, and the result says the values
+   * are unknown (`refreshedFrom: null`).
    */
   async resetConsumable(key2) {
     const spec = consumableSpec(key2);
     if (spec === void 0 || spec.reset === null) {
       throw new DreameError(`resetConsumable: no reset action for consumable "${key2}"`);
     }
-    return this.callAction(spec.reset.siid, spec.reset.aiid, []);
+    const actionResult = await this.callAction(spec.reset.siid, spec.reset.aiid, []);
+    const refresh2 = await this.#rereadConsumable(spec);
+    const fresh = refresh2.refreshedFrom !== null;
+    return {
+      key: key2,
+      actionResult,
+      refreshedFrom: refresh2.refreshedFrom,
+      leftPct: fresh ? this.consumableLeftPct(key2) : null,
+      timeLeft: fresh ? this.consumableTimeLeft(key2) : null,
+      refreshError: refresh2.error
+    };
+  }
+  /** One targeted re-read of a consumable's properties: live, else the cloud shadow. */
+  async #rereadConsumable(spec) {
+    const props = consumableProps(spec);
+    let liveError;
+    try {
+      await this.refreshProperties(props);
+      return { refreshedFrom: "device", error: null };
+    } catch (err) {
+      liveError = asError(err);
+    }
+    try {
+      await this.refreshCachedProperties(props);
+      return { refreshedFrom: "cloud-shadow", error: liveError };
+    } catch (err) {
+      return { refreshedFrom: null, error: asError(err) };
+    }
   }
   // -- AI obstacle-detection ----------------------------------------------
   /**
@@ -5304,7 +5400,9 @@ var VacuumDevice = class _VacuumDevice extends BaseDevice {
         break;
       }
       if (Date.now() + pollMs >= deadline) {
-        throw new DreameError("wifi signal map not available (none stored yet, or request timed out)");
+        throw new DreameError(
+          "wifi signal map not available (none stored yet, or request timed out)"
+        );
       }
       await new Promise((r) => setTimeout(r, pollMs));
     }