@apocaliss92/nodedreame 1.7.2 → 1.8.1

package/dist/index.cjs

@@ -32,6 +32,7 @@ var index_exports = {};
 __export(index_exports, {
   AI_FEATURE_BIT: () => AI_FEATURE_BIT,
   AI_FEATURE_JSON_KEY: () => AI_FEATURE_JSON_KEY,
+  AUTO_SWITCH_JSON_KEY: () => AUTO_SWITCH_JSON_KEY,
   BaseDevice: () => BaseDevice,
   ChargingStatus: () => ChargingStatus,
   CleaningMode: () => CleaningMode,
@@ -64,19 +65,23 @@ __export(index_exports, {
   createClientDumper: () => createClientDumper,
   createDumper: () => createDumper,
   decodeAiFeature: () => decodeAiFeature,
+  decodeAutoSwitch: () => decodeAutoSwitch,
+  decodeAutoSwitchAll: () => decodeAutoSwitchAll,
   encodeAiFeatureWrite: () => encodeAiFeatureWrite,
+  encodeAutoSwitchWrite: () => encodeAutoSwitchWrite,
   getMowerCapabilities: () => getMowerCapabilities,
   getVacuumCapabilities: () => getVacuumCapabilities,
   isDreameConsumableKey: () => isDreameConsumableKey,
   renderMowerSvg: () => renderMowerSvg,
   renderVacuumPng: () => renderVacuumPng,
-  resolveCapabilities: () => resolveCapabilities
+  resolveCapabilities: () => resolveCapabilities,
+  supportedAutoSwitchKeys: () => supportedAutoSwitchKeys
 });
 module.exports = __toCommonJS(index_exports);
 
 // 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 {
@@ -1233,6 +1238,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). */
@@ -1646,6 +1657,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 } },
@@ -1853,11 +1963,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(
@@ -2493,7 +2635,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);
@@ -2962,6 +3104,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));
@@ -4877,6 +5076,7 @@ function createClientDumper(client, options) {
 0 && (module.exports = {
   AI_FEATURE_BIT,
   AI_FEATURE_JSON_KEY,
+  AUTO_SWITCH_JSON_KEY,
   BaseDevice,
   ChargingStatus,
   CleaningMode,
@@ -4909,12 +5109,16 @@ function createClientDumper(client, options) {
   createClientDumper,
   createDumper,
   decodeAiFeature,
+  decodeAutoSwitch,
+  decodeAutoSwitchAll,
   encodeAiFeatureWrite,
+  encodeAutoSwitchWrite,
   getMowerCapabilities,
   getVacuumCapabilities,
   isDreameConsumableKey,
   renderMowerSvg,
   renderVacuumPng,
-  resolveCapabilities
+  resolveCapabilities,
+  supportedAutoSwitchKeys
 });
 //# sourceMappingURL=index.cjs.map