@apocaliss92/nodedreame 1.7.2 → 1.8.1

package/dist/index.d.cts

@@ -755,6 +755,58 @@ declare function decodeAiFeature(raw: AiDetectionRaw, feature: DreameAiFeature):
  */
 declare function encodeAiFeatureWrite(raw: AiDetectionRaw, feature: DreameAiFeature, value: boolean): number | string;
 
+/**
+ * Auto-switch settings codec. The robot packs a large bundle of secondary
+ * cleaning toggles + multi-value settings into a SINGLE MIoT property —
+ * `AUTO_SWITCH_SETTINGS` (siid 4 piid 50) — whose value is a JSON string.
+ * Ported from the Tasshack `dreame-vacuum` HA integration (v2.0.0b25,
+ * `DreameVacuumAutoSwitchProperty` + `set_auto_switch_property`):
+ *
+ *   - READ  : a JSON LIST `[{"k":"LessColl","v":1}, …]` (or a single
+ *             `{"k":…,"v":…}` object) — every supported key/value pair.
+ *   - WRITE : a SINGLE `{"k":"LessColl","v":0}` object carrying ONLY the
+ *             changed key; the device merges it server-side.
+ *
+ * Unlike `AI_DETECTION` this family is JSON-ONLY (no int-bitmask variant) and the
+ * values are arbitrary ints (booleans 0/1, small enums, and `-1`/`-n` "not
+ * applicable" sentinels) — the codec returns the raw int and leaves the
+ * boolean-vs-enum interpretation to the caller. Presence is data-driven: a key is
+ * "supported" iff it appears in the decoded payload (exactly how Tasshack derives
+ * `auto_switch_data`).
+ */
+/** Canonical auto-switch keys. A given model reports a subset. */
+type AutoSwitchKey = 'collisionAvoidance' | 'fillLight' | 'autoDrying' | 'stainAvoidance' | 'moppingType' | 'cleanGenius' | 'widerCornerCoverage' | 'floorDirectionCleaning' | 'petFocusedCleaning' | 'autoRecleaning' | 'autoRewashing' | 'mopPadSwing' | 'autoCharging' | 'humanFollow' | 'maxSuctionPower' | 'smartDrying' | 'drainageConfirmResult' | 'drainageTestResult' | 'hotWashing' | 'uvSterilization' | 'cleaningRoute' | 'customMoppingMode' | 'moppingMode' | 'selfCleanFrequency' | 'intensiveCarpetCleaning' | 'gapCleaningExtension' | 'moppingUnderFurnitures' | 'ultraCleanMode' | 'streamingVoicePrompt' | 'mopExtend' | 'mopExtendFrequency' | 'sideReach' | 'intelligentStainCleaning';
+/**
+ * Short on-wire key for each setting inside the `AUTO_SWITCH_SETTINGS` JSON
+ * (Tasshack `DreameVacuumAutoSwitchProperty`). These opaque strings are the
+ * device's own identifiers and must match byte-for-byte.
+ */
+declare const AUTO_SWITCH_JSON_KEY: Readonly<Record<AutoSwitchKey, string>>;
+/** The raw on-wire `AUTO_SWITCH_SETTINGS` value: a JSON string, or absent. */
+type AutoSwitchRaw = string | null;
+/**
+ * Decode ONE auto-switch setting's int value from the packed
+ * `AUTO_SWITCH_SETTINGS` payload. Returns `null` when the value is absent or the
+ * key is not present in the payload (i.e. unsupported by this model/firmware).
+ */
+declare function decodeAutoSwitch(raw: AutoSwitchRaw, key: AutoSwitchKey): number | null;
+/**
+ * The auto-switch keys the payload actually reports (presence-driven — mirrors
+ * Tasshack `auto_switch_data`). On-wire keys with no canonical mapping (newer
+ * firmware extras like `MopFullyScalable`) are skipped. Order follows
+ * {@link AUTO_SWITCH_JSON_KEY} for determinism.
+ */
+declare function supportedAutoSwitchKeys(raw: AutoSwitchRaw): readonly AutoSwitchKey[];
+/** All `{ canonical key → int }` pairs the payload reports (canonical keys only). */
+declare function decodeAutoSwitchAll(raw: AutoSwitchRaw): Readonly<Partial<Record<AutoSwitchKey, number>>>;
+/**
+ * Compute the value to WRITE to `AUTO_SWITCH_SETTINGS` for ONE setting. Mirrors
+ * Tasshack `set_auto_switch_property`: a SINGLE `{"k":<key>,"v":<int>}` object
+ * (NOT the full list) — the device merges it server-side, so the other settings
+ * are preserved without a read-modify-write.
+ */
+declare function encodeAutoSwitchWrite(key: AutoSwitchKey, value: number): string;
+
 /**
  * Vacuum consumable/maintenance map (ported from Tasshack `dreame-vacuum`
  * v2.0.0b25 — property + action mappings). Each consumable lives on its own MIoT
@@ -1370,6 +1422,43 @@ declare class VacuumDevice extends BaseDevice<VacuumDeviceEvents> {
      * is unknown (a blind write would clobber the other toggles).
      */
     setAiFeature(feature: DreameAiFeature, value: boolean): Promise<unknown>;
+    /**
+     * The raw `AUTO_SWITCH_SETTINGS` value (siid 4 piid 50) — a JSON string packing
+     * every secondary toggle/setting — or `null` when not yet observed. Prefer the
+     * decoded {@link autoSwitchProperty} / {@link supportedAutoSwitchKeys} surface.
+     */
+    get autoSwitchRaw(): AutoSwitchRaw;
+    /** Whether this model reports the packed auto-switch bundle at all. */
+    get hasAutoSwitchSettings(): boolean;
+    /**
+     * The auto-switch settings this model reports, decoded from the packed value.
+     * Presence-driven (a key appears iff the payload carries it) — mirrors
+     * Tasshack `auto_switch_data`.
+     */
+    get supportedAutoSwitchKeys(): readonly AutoSwitchKey[];
+    /**
+     * Read ONE auto-switch setting's int value, decoded from the packed
+     * `AUTO_SWITCH_SETTINGS` payload. `null` when the value is unobserved or the
+     * key is not present. The value is an opaque int (boolean 0/1, a small enum, or
+     * a `-1`/`-n` "not applicable" sentinel) — the caller interprets it.
+     */
+    autoSwitchProperty(key: AutoSwitchKey): number | null;
+    /**
+     * Seed {@link autoSwitchRaw} from the CLOUD SHADOW (the last value the robot
+     * pushed for `AUTO_SWITCH_SETTINGS`, siid 4 piid 50) WITHOUT waking it. Like the
+     * AI bundle these 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 settings. Returns the resolved raw value (`null` when the
+     * shadow carries none yet).
+     */
+    refreshAutoSwitch(): Promise<AutoSwitchRaw>;
+    /**
+     * Set ONE auto-switch setting. Mirrors Tasshack `set_auto_switch_property`: a
+     * single-key `{"k":<key>,"v":<int>}` write the device merges server-side (the
+     * other settings are preserved without a read-modify-write). Rejects when the
+     * model does not report the bundle.
+     */
+    setAutoSwitchProperty(key: AutoSwitchKey, value: number): Promise<unknown>;
     /**
      * Start cleaning (MIoT action siid 2 aiid 1). Named `startCleaning` — NOT
      * `start` — because `BaseDevice.start()` is the lifecycle method that opens
@@ -2318,4 +2407,4 @@ declare function createDumper(target: DumperDevice, options?: DumperOptions): Du
  */
 declare function createClientDumper(client: Nodreame, options?: DumperOptions): Dumper[];
 
-export { AI_FEATURE_BIT, AI_FEATURE_JSON_KEY, type AiDetectionRaw, BaseDevice, type BaseDeviceEvents, type BatchDeviceDataFetcher, type CapabilityResolver, ChargingStatus, type CleanOpts, CleaningMode, type ConsumableReading, type ConsumableSpec, type CreateDeviceArgs, DefaultCapabilityResolver, type DeviceCapabilities, type DeviceDump, type DeviceEvent, type DreameAiFeature, DreameApiError, DreameAuthError, type DreameCloudState, type DreameConsumableKey, type DreameDevice, DreameDeviceOfflineError, DreameError, type DreameRegion, type DreameSession, DreameTransportError, type DumperOptions, LIBRARY_NAME, MODEL_CAPABILITIES as MOWER_MODEL_CAPABILITIES, type MapBoundingBox, type MapCleanedAreaOverlay, 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 MowerAvailableMap, type MowerCapabilities, MowerCapabilityResolver, MowerChargingStatus, type MowerContour, MowerControlAction, type MowerControlState, MowerDevice, type MowerDeviceInput, MowerFault, type MowerMap, type MowerMapBoundary, type MowerMowPath, type MowerPathEntry, type MowerPoint, type MowerSpotArea, MowerStatus, type MowerTaskDescriptor, MowerTaskStatus, type MowerZone, Nodreame, type NodreameDeps, type NodreameEvents, type NodreameOptions, type OssFetchInput, type OssFetcherLike, type PropertyChangedEvent, type PropertyResult, type PropertyState, type PropertyWrite, type RenderMowerSvgOptions, type RenderVacuumPngOptions, type StateChangedEvent, SuctionLevel, TaskStatus, VACUUM_CONSUMABLES, MODEL_CAPABILITIES$1 as VACUUM_MODEL_CAPABILITIES, type VacuumCapabilities, VacuumCapabilityResolver, VacuumDevice, type VacuumGetMapInput, type VacuumMap, WaterVolume, consumableSpec, createClientDumper, createDumper, decodeAiFeature, encodeAiFeatureWrite, getMowerCapabilities, getVacuumCapabilities, isDreameConsumableKey, renderMowerSvg, renderVacuumPng, resolveCapabilities };
+export { AI_FEATURE_BIT, AI_FEATURE_JSON_KEY, AUTO_SWITCH_JSON_KEY, type AiDetectionRaw, type AutoSwitchKey, type AutoSwitchRaw, BaseDevice, type BaseDeviceEvents, type BatchDeviceDataFetcher, type CapabilityResolver, ChargingStatus, type CleanOpts, CleaningMode, type ConsumableReading, type ConsumableSpec, type CreateDeviceArgs, DefaultCapabilityResolver, type DeviceCapabilities, type DeviceDump, type DeviceEvent, type DreameAiFeature, DreameApiError, DreameAuthError, type DreameCloudState, type DreameConsumableKey, type DreameDevice, DreameDeviceOfflineError, DreameError, type DreameRegion, type DreameSession, DreameTransportError, type DumperOptions, LIBRARY_NAME, MODEL_CAPABILITIES as MOWER_MODEL_CAPABILITIES, type MapBoundingBox, type MapCleanedAreaOverlay, 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 MowerAvailableMap, type MowerCapabilities, MowerCapabilityResolver, MowerChargingStatus, type MowerContour, MowerControlAction, type MowerControlState, MowerDevice, type MowerDeviceInput, MowerFault, type MowerMap, type MowerMapBoundary, type MowerMowPath, type MowerPathEntry, type MowerPoint, type MowerSpotArea, MowerStatus, type MowerTaskDescriptor, MowerTaskStatus, type MowerZone, Nodreame, type NodreameDeps, type NodreameEvents, type NodreameOptions, type OssFetchInput, type OssFetcherLike, type PropertyChangedEvent, type PropertyResult, type PropertyState, type PropertyWrite, type RenderMowerSvgOptions, type RenderVacuumPngOptions, type StateChangedEvent, SuctionLevel, TaskStatus, VACUUM_CONSUMABLES, MODEL_CAPABILITIES$1 as VACUUM_MODEL_CAPABILITIES, type VacuumCapabilities, VacuumCapabilityResolver, VacuumDevice, type VacuumGetMapInput, type VacuumMap, WaterVolume, consumableSpec, createClientDumper, createDumper, decodeAiFeature, decodeAutoSwitch, decodeAutoSwitchAll, encodeAiFeatureWrite, encodeAutoSwitchWrite, getMowerCapabilities, getVacuumCapabilities, isDreameConsumableKey, renderMowerSvg, renderVacuumPng, resolveCapabilities, supportedAutoSwitchKeys };

package/dist/index.d.ts

@@ -755,6 +755,58 @@ declare function decodeAiFeature(raw: AiDetectionRaw, feature: DreameAiFeature):
  */
 declare function encodeAiFeatureWrite(raw: AiDetectionRaw, feature: DreameAiFeature, value: boolean): number | string;
 
+/**
+ * Auto-switch settings codec. The robot packs a large bundle of secondary
+ * cleaning toggles + multi-value settings into a SINGLE MIoT property —
+ * `AUTO_SWITCH_SETTINGS` (siid 4 piid 50) — whose value is a JSON string.
+ * Ported from the Tasshack `dreame-vacuum` HA integration (v2.0.0b25,
+ * `DreameVacuumAutoSwitchProperty` + `set_auto_switch_property`):
+ *
+ *   - READ  : a JSON LIST `[{"k":"LessColl","v":1}, …]` (or a single
+ *             `{"k":…,"v":…}` object) — every supported key/value pair.
+ *   - WRITE : a SINGLE `{"k":"LessColl","v":0}` object carrying ONLY the
+ *             changed key; the device merges it server-side.
+ *
+ * Unlike `AI_DETECTION` this family is JSON-ONLY (no int-bitmask variant) and the
+ * values are arbitrary ints (booleans 0/1, small enums, and `-1`/`-n` "not
+ * applicable" sentinels) — the codec returns the raw int and leaves the
+ * boolean-vs-enum interpretation to the caller. Presence is data-driven: a key is
+ * "supported" iff it appears in the decoded payload (exactly how Tasshack derives
+ * `auto_switch_data`).
+ */
+/** Canonical auto-switch keys. A given model reports a subset. */
+type AutoSwitchKey = 'collisionAvoidance' | 'fillLight' | 'autoDrying' | 'stainAvoidance' | 'moppingType' | 'cleanGenius' | 'widerCornerCoverage' | 'floorDirectionCleaning' | 'petFocusedCleaning' | 'autoRecleaning' | 'autoRewashing' | 'mopPadSwing' | 'autoCharging' | 'humanFollow' | 'maxSuctionPower' | 'smartDrying' | 'drainageConfirmResult' | 'drainageTestResult' | 'hotWashing' | 'uvSterilization' | 'cleaningRoute' | 'customMoppingMode' | 'moppingMode' | 'selfCleanFrequency' | 'intensiveCarpetCleaning' | 'gapCleaningExtension' | 'moppingUnderFurnitures' | 'ultraCleanMode' | 'streamingVoicePrompt' | 'mopExtend' | 'mopExtendFrequency' | 'sideReach' | 'intelligentStainCleaning';
+/**
+ * Short on-wire key for each setting inside the `AUTO_SWITCH_SETTINGS` JSON
+ * (Tasshack `DreameVacuumAutoSwitchProperty`). These opaque strings are the
+ * device's own identifiers and must match byte-for-byte.
+ */
+declare const AUTO_SWITCH_JSON_KEY: Readonly<Record<AutoSwitchKey, string>>;
+/** The raw on-wire `AUTO_SWITCH_SETTINGS` value: a JSON string, or absent. */
+type AutoSwitchRaw = string | null;
+/**
+ * Decode ONE auto-switch setting's int value from the packed
+ * `AUTO_SWITCH_SETTINGS` payload. Returns `null` when the value is absent or the
+ * key is not present in the payload (i.e. unsupported by this model/firmware).
+ */
+declare function decodeAutoSwitch(raw: AutoSwitchRaw, key: AutoSwitchKey): number | null;
+/**
+ * The auto-switch keys the payload actually reports (presence-driven — mirrors
+ * Tasshack `auto_switch_data`). On-wire keys with no canonical mapping (newer
+ * firmware extras like `MopFullyScalable`) are skipped. Order follows
+ * {@link AUTO_SWITCH_JSON_KEY} for determinism.
+ */
+declare function supportedAutoSwitchKeys(raw: AutoSwitchRaw): readonly AutoSwitchKey[];
+/** All `{ canonical key → int }` pairs the payload reports (canonical keys only). */
+declare function decodeAutoSwitchAll(raw: AutoSwitchRaw): Readonly<Partial<Record<AutoSwitchKey, number>>>;
+/**
+ * Compute the value to WRITE to `AUTO_SWITCH_SETTINGS` for ONE setting. Mirrors
+ * Tasshack `set_auto_switch_property`: a SINGLE `{"k":<key>,"v":<int>}` object
+ * (NOT the full list) — the device merges it server-side, so the other settings
+ * are preserved without a read-modify-write.
+ */
+declare function encodeAutoSwitchWrite(key: AutoSwitchKey, value: number): string;
+
 /**
  * Vacuum consumable/maintenance map (ported from Tasshack `dreame-vacuum`
  * v2.0.0b25 — property + action mappings). Each consumable lives on its own MIoT
@@ -1370,6 +1422,43 @@ declare class VacuumDevice extends BaseDevice<VacuumDeviceEvents> {
      * is unknown (a blind write would clobber the other toggles).
      */
     setAiFeature(feature: DreameAiFeature, value: boolean): Promise<unknown>;
+    /**
+     * The raw `AUTO_SWITCH_SETTINGS` value (siid 4 piid 50) — a JSON string packing
+     * every secondary toggle/setting — or `null` when not yet observed. Prefer the
+     * decoded {@link autoSwitchProperty} / {@link supportedAutoSwitchKeys} surface.
+     */
+    get autoSwitchRaw(): AutoSwitchRaw;
+    /** Whether this model reports the packed auto-switch bundle at all. */
+    get hasAutoSwitchSettings(): boolean;
+    /**
+     * The auto-switch settings this model reports, decoded from the packed value.
+     * Presence-driven (a key appears iff the payload carries it) — mirrors
+     * Tasshack `auto_switch_data`.
+     */
+    get supportedAutoSwitchKeys(): readonly AutoSwitchKey[];
+    /**
+     * Read ONE auto-switch setting's int value, decoded from the packed
+     * `AUTO_SWITCH_SETTINGS` payload. `null` when the value is unobserved or the
+     * key is not present. The value is an opaque int (boolean 0/1, a small enum, or
+     * a `-1`/`-n` "not applicable" sentinel) — the caller interprets it.
+     */
+    autoSwitchProperty(key: AutoSwitchKey): number | null;
+    /**
+     * Seed {@link autoSwitchRaw} from the CLOUD SHADOW (the last value the robot
+     * pushed for `AUTO_SWITCH_SETTINGS`, siid 4 piid 50) WITHOUT waking it. Like the
+     * AI bundle these 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 settings. Returns the resolved raw value (`null` when the
+     * shadow carries none yet).
+     */
+    refreshAutoSwitch(): Promise<AutoSwitchRaw>;
+    /**
+     * Set ONE auto-switch setting. Mirrors Tasshack `set_auto_switch_property`: a
+     * single-key `{"k":<key>,"v":<int>}` write the device merges server-side (the
+     * other settings are preserved without a read-modify-write). Rejects when the
+     * model does not report the bundle.
+     */
+    setAutoSwitchProperty(key: AutoSwitchKey, value: number): Promise<unknown>;
     /**
      * Start cleaning (MIoT action siid 2 aiid 1). Named `startCleaning` — NOT
      * `start` — because `BaseDevice.start()` is the lifecycle method that opens
@@ -2318,4 +2407,4 @@ declare function createDumper(target: DumperDevice, options?: DumperOptions): Du
  */
 declare function createClientDumper(client: Nodreame, options?: DumperOptions): Dumper[];
 
-export { AI_FEATURE_BIT, AI_FEATURE_JSON_KEY, type AiDetectionRaw, BaseDevice, type BaseDeviceEvents, type BatchDeviceDataFetcher, type CapabilityResolver, ChargingStatus, type CleanOpts, CleaningMode, type ConsumableReading, type ConsumableSpec, type CreateDeviceArgs, DefaultCapabilityResolver, type DeviceCapabilities, type DeviceDump, type DeviceEvent, type DreameAiFeature, DreameApiError, DreameAuthError, type DreameCloudState, type DreameConsumableKey, type DreameDevice, DreameDeviceOfflineError, DreameError, type DreameRegion, type DreameSession, DreameTransportError, type DumperOptions, LIBRARY_NAME, MODEL_CAPABILITIES as MOWER_MODEL_CAPABILITIES, type MapBoundingBox, type MapCleanedAreaOverlay, 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 MowerAvailableMap, type MowerCapabilities, MowerCapabilityResolver, MowerChargingStatus, type MowerContour, MowerControlAction, type MowerControlState, MowerDevice, type MowerDeviceInput, MowerFault, type MowerMap, type MowerMapBoundary, type MowerMowPath, type MowerPathEntry, type MowerPoint, type MowerSpotArea, MowerStatus, type MowerTaskDescriptor, MowerTaskStatus, type MowerZone, Nodreame, type NodreameDeps, type NodreameEvents, type NodreameOptions, type OssFetchInput, type OssFetcherLike, type PropertyChangedEvent, type PropertyResult, type PropertyState, type PropertyWrite, type RenderMowerSvgOptions, type RenderVacuumPngOptions, type StateChangedEvent, SuctionLevel, TaskStatus, VACUUM_CONSUMABLES, MODEL_CAPABILITIES$1 as VACUUM_MODEL_CAPABILITIES, type VacuumCapabilities, VacuumCapabilityResolver, VacuumDevice, type VacuumGetMapInput, type VacuumMap, WaterVolume, consumableSpec, createClientDumper, createDumper, decodeAiFeature, encodeAiFeatureWrite, getMowerCapabilities, getVacuumCapabilities, isDreameConsumableKey, renderMowerSvg, renderVacuumPng, resolveCapabilities };
+export { AI_FEATURE_BIT, AI_FEATURE_JSON_KEY, AUTO_SWITCH_JSON_KEY, type AiDetectionRaw, type AutoSwitchKey, type AutoSwitchRaw, BaseDevice, type BaseDeviceEvents, type BatchDeviceDataFetcher, type CapabilityResolver, ChargingStatus, type CleanOpts, CleaningMode, type ConsumableReading, type ConsumableSpec, type CreateDeviceArgs, DefaultCapabilityResolver, type DeviceCapabilities, type DeviceDump, type DeviceEvent, type DreameAiFeature, DreameApiError, DreameAuthError, type DreameCloudState, type DreameConsumableKey, type DreameDevice, DreameDeviceOfflineError, DreameError, type DreameRegion, type DreameSession, DreameTransportError, type DumperOptions, LIBRARY_NAME, MODEL_CAPABILITIES as MOWER_MODEL_CAPABILITIES, type MapBoundingBox, type MapCleanedAreaOverlay, 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 MowerAvailableMap, type MowerCapabilities, MowerCapabilityResolver, MowerChargingStatus, type MowerContour, MowerControlAction, type MowerControlState, MowerDevice, type MowerDeviceInput, MowerFault, type MowerMap, type MowerMapBoundary, type MowerMowPath, type MowerPathEntry, type MowerPoint, type MowerSpotArea, MowerStatus, type MowerTaskDescriptor, MowerTaskStatus, type MowerZone, Nodreame, type NodreameDeps, type NodreameEvents, type NodreameOptions, type OssFetchInput, type OssFetcherLike, type PropertyChangedEvent, type PropertyResult, type PropertyState, type PropertyWrite, type RenderMowerSvgOptions, type RenderVacuumPngOptions, type StateChangedEvent, SuctionLevel, TaskStatus, VACUUM_CONSUMABLES, MODEL_CAPABILITIES$1 as VACUUM_MODEL_CAPABILITIES, type VacuumCapabilities, VacuumCapabilityResolver, VacuumDevice, type VacuumGetMapInput, type VacuumMap, WaterVolume, consumableSpec, createClientDumper, createDumper, decodeAiFeature, decodeAutoSwitch, decodeAutoSwitchAll, encodeAiFeatureWrite, encodeAutoSwitchWrite, getMowerCapabilities, getVacuumCapabilities, isDreameConsumableKey, renderMowerSvg, renderVacuumPng, resolveCapabilities, supportedAutoSwitchKeys };

package/dist/index.js

@@ -1,6 +1,6 @@
 // src/support/version.ts
 var LIBRARY_NAME = "nodedreame";
-var LIBRARY_VERSION = "1.7.2";
+var LIBRARY_VERSION = "1.8.1";
 
 // src/transport/errors.ts
 var DreameError = class extends Error {
@@ -1157,6 +1157,12 @@ var VACUUM_PROP = {
    * via `ai-detection.ts` ({@link decodeAiFeature} / {@link encodeAiFeatureWrite}).
    */
   AI_DETECTION: { siid: 4, piid: 22 },
+  /**
+   * Auto-switch settings bundle (Tasshack types.py — `AUTO_SWITCH_SETTINGS`,
+   * siid 4 piid 50). A JSON string packing every secondary toggle/setting as
+   * `[{"k":<key>,"v":<int>}, …]`. Decode/encode per-setting via `auto-switch.ts`.
+   */
+  AUTO_SWITCH_SETTINGS: { siid: 4, piid: 50 },
   /** VERIFIED r2532a 2026-05-03 — task progress percentage 0..100. */
   TASK_PROGRESS_PCT: { siid: 4, piid: 63 },
   /** VERIFIED r2532a — mop-drying progress (minutes ticking during MopDrying). */
@@ -1570,6 +1576,105 @@ function encodeAiFeatureWrite(raw, feature, value) {
   );
 }
 
+// src/models/vacuum/auto-switch.ts
+var AUTO_SWITCH_JSON_KEY = {
+  collisionAvoidance: "LessColl",
+  fillLight: "FillinLight",
+  autoDrying: "AutoDry",
+  stainAvoidance: "StainIdentify",
+  moppingType: "CleanType",
+  cleanGenius: "SmartHost",
+  widerCornerCoverage: "MeticulousTwist",
+  floorDirectionCleaning: "MaterialDirectionClean",
+  petFocusedCleaning: "PetPartClean",
+  autoRecleaning: "SmartAutoMop",
+  autoRewashing: "SmartAutoWash",
+  mopPadSwing: "MopScalable",
+  autoCharging: "SmartCharge",
+  humanFollow: "MonitorHumanFollow",
+  maxSuctionPower: "SuctionMax",
+  smartDrying: "SmartDrying",
+  drainageConfirmResult: "FluctuationConfirmResult",
+  drainageTestResult: "FluctuationTestResult",
+  hotWashing: "HotWash",
+  uvSterilization: "UVLight",
+  cleaningRoute: "CleanRoute",
+  customMoppingMode: "MopEffectSwitch",
+  moppingMode: "MopEffectState",
+  selfCleanFrequency: "BackWashType",
+  intensiveCarpetCleaning: "CarpetFineClean",
+  gapCleaningExtension: "LacuneMopScalable",
+  moppingUnderFurnitures: "MopScalable2",
+  ultraCleanMode: "SuperWash",
+  streamingVoicePrompt: "MonitorPromptLevel",
+  mopExtend: "MopExtrSwitch",
+  mopExtendFrequency: "ExtrFreq",
+  sideReach: "SbrushExtrSwitch",
+  intelligentStainCleaning: "HeavyStainSmart"
+};
+var JSON_KEY_TO_CANONICAL = Object.fromEntries(
+  Object.entries(AUTO_SWITCH_JSON_KEY).map(([k, v]) => [v, k])
+);
+function coerceInt(v) {
+  if (typeof v === "number") return Number.isFinite(v) ? v : null;
+  if (typeof v === "string" && v.trim() !== "") {
+    const n = Number(v);
+    return Number.isFinite(n) ? n : null;
+  }
+  return null;
+}
+function parseAutoSwitchMap(raw) {
+  if (typeof raw !== "string" || raw.length <= 2) return null;
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return null;
+  }
+  const out = /* @__PURE__ */ new Map();
+  const add = (entry) => {
+    if (entry === null || typeof entry !== "object") return;
+    const rec = entry;
+    if (typeof rec["k"] !== "string") return;
+    const value = coerceInt(rec["v"]);
+    if (value !== null) out.set(rec["k"], value);
+  };
+  if (Array.isArray(parsed)) {
+    for (const entry of parsed) add(entry);
+  } else {
+    add(parsed);
+  }
+  return out.size > 0 ? out : null;
+}
+function decodeAutoSwitch(raw, key2) {
+  const map = parseAutoSwitchMap(raw);
+  if (map === null) return null;
+  const jsonKey = AUTO_SWITCH_JSON_KEY[key2];
+  return map.has(jsonKey) ? map.get(jsonKey) ?? null : null;
+}
+function supportedAutoSwitchKeys(raw) {
+  const map = parseAutoSwitchMap(raw);
+  if (map === null) return [];
+  const present = [];
+  for (const key2 of Object.keys(AUTO_SWITCH_JSON_KEY)) {
+    if (map.has(AUTO_SWITCH_JSON_KEY[key2])) present.push(key2);
+  }
+  return present;
+}
+function decodeAutoSwitchAll(raw) {
+  const map = parseAutoSwitchMap(raw);
+  if (map === null) return {};
+  const out = {};
+  for (const [jsonKey, value] of map) {
+    const canonical = JSON_KEY_TO_CANONICAL[jsonKey];
+    if (canonical !== void 0) out[canonical] = value;
+  }
+  return out;
+}
+function encodeAutoSwitchWrite(key2, value) {
+  return JSON.stringify({ k: AUTO_SWITCH_JSON_KEY[key2], v: Math.trunc(value) });
+}
+
 // src/models/vacuum/consumables.ts
 var VACUUM_CONSUMABLES = [
   { key: "main-brush", label: "Main Brush", life: { siid: 9, piid: 2 }, reset: { siid: 9, aiid: 1 } },
@@ -1777,11 +1882,43 @@ function unwrapEnvelope(value, opts = {}) {
     }
     bytes = aesCbcDecrypt(bytes, key2, opts.iv);
   }
+  let inflated;
   try {
-    return zlib.inflateSync(bytes);
+    inflated = zlib.inflateSync(bytes);
   } catch (err) {
     throw new MapDecodeError("envelope: zlib inflate failed", { cause: err });
   }
+  let guard = 0;
+  while (guard < MAX_EXTRA_WRAP_LAYERS && looksLikeBase64Zlib(inflated)) {
+    const text = inflated.toString("latin1").replace(/-/g, "+").replace(/_/g, "/");
+    try {
+      inflated = zlib.inflateSync(Buffer.from(text, "base64"));
+    } catch (err) {
+      throw new MapDecodeError("envelope: nested zlib inflate failed", { cause: err });
+    }
+    guard += 1;
+  }
+  return inflated;
+}
+var MAX_EXTRA_WRAP_LAYERS = 4;
+function looksLikeBase64Zlib(buf) {
+  if (buf.length < 8) return false;
+  for (const b of buf) {
+    const isB64 = b >= 65 && b <= 90 || // A-Z
+    b >= 97 && b <= 122 || // a-z
+    b >= 48 && b <= 57 || // 0-9
+    b === 43 || b === 47 || // + /
+    b === 45 || b === 95 || // - _ (url-safe)
+    b === 61;
+    if (!isB64) return false;
+  }
+  try {
+    const prefix = buf.subarray(0, 16).toString("latin1").replace(/-/g, "+").replace(/_/g, "/");
+    const decoded = Buffer.from(prefix, "base64");
+    return decoded.length >= 2 && decoded[0] === 120;
+  } catch {
+    return false;
+  }
 }
 function aesCbcDecrypt(cipher, rawKey, iv) {
   const keyBytes = Buffer.from(
@@ -2417,7 +2554,7 @@ function decodeCleanedAreaPixels(pixels, width, height) {
 
 // src/models/vacuum/map/decode.ts
 function decodeVacuumMap(input, opts = {}) {
-  const inflated = typeof input === "string" ? unwrapEnvelope(input, opts) : input;
+  const inflated = typeof input === "string" ? unwrapEnvelope(input, opts) : looksLikeBase64Zlib(input) ? unwrapEnvelope(input.toString("latin1"), opts) : input;
   const { header, tail } = parseFrame(inflated);
   const dimensions = mergeDimensions(header, tail);
   const robot = pose(header.robotX, header.robotY, header.robotA, tail.nr === true);
@@ -2886,6 +3023,63 @@ var VacuumDevice = class _VacuumDevice extends BaseDevice {
     const next = encodeAiFeatureWrite(this.aiDetectionRaw, feature, value);
     return this.setProperty({ ...VACUUM_PROP.AI_DETECTION, value: next });
   }
+  // -- auto-switch settings -----------------------------------------------
+  /**
+   * The raw `AUTO_SWITCH_SETTINGS` value (siid 4 piid 50) — a JSON string packing
+   * every secondary toggle/setting — or `null` when not yet observed. Prefer the
+   * decoded {@link autoSwitchProperty} / {@link supportedAutoSwitchKeys} surface.
+   */
+  get autoSwitchRaw() {
+    const v = this.getProperty(
+      VACUUM_PROP.AUTO_SWITCH_SETTINGS.siid,
+      VACUUM_PROP.AUTO_SWITCH_SETTINGS.piid
+    )?.value;
+    return typeof v === "string" ? v : null;
+  }
+  /** Whether this model reports the packed auto-switch bundle at all. */
+  get hasAutoSwitchSettings() {
+    return this.autoSwitchRaw !== null;
+  }
+  /**
+   * The auto-switch settings this model reports, decoded from the packed value.
+   * Presence-driven (a key appears iff the payload carries it) — mirrors
+   * Tasshack `auto_switch_data`.
+   */
+  get supportedAutoSwitchKeys() {
+    return supportedAutoSwitchKeys(this.autoSwitchRaw);
+  }
+  /**
+   * Read ONE auto-switch setting's int value, decoded from the packed
+   * `AUTO_SWITCH_SETTINGS` payload. `null` when the value is unobserved or the
+   * key is not present. The value is an opaque int (boolean 0/1, a small enum, or
+   * a `-1`/`-n` "not applicable" sentinel) — the caller interprets it.
+   */
+  autoSwitchProperty(key2) {
+    return decodeAutoSwitch(this.autoSwitchRaw, key2);
+  }
+  /**
+   * Seed {@link autoSwitchRaw} from the CLOUD SHADOW (the last value the robot
+   * pushed for `AUTO_SWITCH_SETTINGS`, siid 4 piid 50) WITHOUT waking it. Like the
+   * AI bundle these 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 settings. Returns the resolved raw value (`null` when the
+   * shadow carries none yet).
+   */
+  async refreshAutoSwitch() {
+    await this.refreshCachedProperties([VACUUM_PROP.AUTO_SWITCH_SETTINGS]);
+    return this.autoSwitchRaw;
+  }
+  /**
+   * Set ONE auto-switch setting. Mirrors Tasshack `set_auto_switch_property`: a
+   * single-key `{"k":<key>,"v":<int>}` write the device merges server-side (the
+   * other settings are preserved without a read-modify-write). Rejects when the
+   * model does not report the bundle.
+   */
+  async setAutoSwitchProperty(key2, value) {
+    this.#requireCap(this.hasAutoSwitchSettings, "setAutoSwitchProperty", "auto-switch settings");
+    const next = encodeAutoSwitchWrite(key2, value);
+    return this.setProperty({ ...VACUUM_PROP.AUTO_SWITCH_SETTINGS, value: next });
+  }
   // -- command helpers ----------------------------------------------------
   #resolveCleanOpts(opts) {
     const repeats = Math.max(1, Math.trunc(opts.repeats ?? 1));
@@ -4800,6 +4994,7 @@ function createClientDumper(client, options) {
 export {
   AI_FEATURE_BIT,
   AI_FEATURE_JSON_KEY,
+  AUTO_SWITCH_JSON_KEY,
   BaseDevice,
   ChargingStatus,
   CleaningMode,
@@ -4832,12 +5027,16 @@ export {
   createClientDumper,
   createDumper,
   decodeAiFeature,
+  decodeAutoSwitch,
+  decodeAutoSwitchAll,
   encodeAiFeatureWrite,
+  encodeAutoSwitchWrite,
   getMowerCapabilities,
   getVacuumCapabilities,
   isDreameConsumableKey,
   renderMowerSvg,
   renderVacuumPng,
-  resolveCapabilities
+  resolveCapabilities,
+  supportedAutoSwitchKeys
 };
 //# sourceMappingURL=index.js.map