@mega-yfue/eufy-sdk 0.5.0-beta.53 → 0.5.0-beta.55

package/dist/client/eufy-mega.d.ts

@@ -792,9 +792,9 @@ export declare class EufyMega extends EventEmitter {
      * Subscribe the devices on one credential scope; a failing subscribe is reported, not fatal (one
      * unreachable device must not stop the rest of the roster from coming up).
      *
-     * A Tuya clean-line device's DPs are also read from the Tuya cloud, whether or not its subscribe
-     * succeeded: the cloud read is a separate plane, and the broker can refuse a subscribe for a device
-     * whose DPs the Tuya cloud still serves.
+     * A Tuya clean-line device (`eufy_home_tuya`) is not subscribed: its state lives on the Tuya cloud,
+     * and the broker refuses its `eufy_home` topics on every credential. Its DPs are read from the Tuya
+     * cloud instead.
      */
     private subscribeMqttDevices;
     /**

package/dist/core/contracts.d.ts

@@ -458,7 +458,7 @@ export interface CommandSink {
     dispatch(cmd: Command): Promise<void>;
 }
 /**
- * Inbound Tuya DP event contract — the transport parses a ThingClips MQTT payload
+ * Inbound Tuya DP event contract — the transport parses the Tuya cloud DP read
  * (string-keyed object → numeric-keyed record) and delivers it through this interface. The
  * transport owns the parse; a capability owns the semantics (which DP id means what). Mirrors
  * {@link DpInboundFrame} for the AIoT MQTT path; the capability layer never names the Tuya framing.

package/dist/index.js

@@ -2963,6 +2963,8 @@ var KNOWN_VALUE_KINDS = [
   "dbm",
   "seconds",
   "hours",
+  "minutes",
+  "millimetres",
   "megabytes",
   "degrees",
   "scalar",
@@ -10663,6 +10665,221 @@ var SUCTION = {
   }
 };
 
+// dist/model/capabilities/mower.js
+var MOWER_DP = {
+  BATTERY: 8,
+  VOLUME: 26,
+  CHILD_LOCK: 47,
+  RAIN_AUTO_RETURN: 101,
+  WIFI_SIGNAL: 109,
+  MOW_HEIGHT: 110,
+  SAVE_MAP_PROGRESS: 118,
+  STATION_USED_TIME: 125,
+  BLADE_USED_TIME: 126,
+  EDGE_TRIM: 128,
+  WORK_ANGLE_ENABLED: 130,
+  WORK_ANGLE: 131,
+  SMART_NO_GO_ZONES: 132,
+  BIRD_VIEW_CAPTURE: 133,
+  NETWORK: 134,
+  CELLULAR_ENABLED: 137,
+  EDGE_DISTANCE: 139,
+  GPS_ANTI_THEFT: 140,
+  SPARSE_LAWN_OPTIMIZATION: 141
+};
+var MOWER_NETWORKS = ["None", "Wifi", "Cellular"];
+var MOWER_MEMBERS = {
+  /** Charge percentage (DP 8, `battery_percentage`). */
+  battery: {
+    param: MOWER_DP.BATTERY,
+    type: "number",
+    unit: "%",
+    kind: "percent",
+    provenance: "mega",
+    description: "Battery level 0-100 (DP 8, battery_percentage). Read-only."
+  },
+  /** Speaker volume (DP 26, `volume_set`). */
+  volume: {
+    param: MOWER_DP.VOLUME,
+    type: "number",
+    unit: "%",
+    kind: "percent",
+    provenance: "mega",
+    description: "Speaker volume 0-100 (DP 26, volume_set). Read-only."
+  },
+  /** Whether the child lock is on (DP 47, `child_lock`). */
+  childLock: {
+    param: MOWER_DP.CHILD_LOCK,
+    type: "bool",
+    kind: "boolean",
+    provenance: "mega",
+    description: "Child lock on (DP 47, child_lock). Read-only."
+  },
+  /** Whether the mower returns to its station when it detects rain (DP 101, `rain_auto_return`). */
+  rainAutoReturn: {
+    param: MOWER_DP.RAIN_AUTO_RETURN,
+    type: "bool",
+    kind: "boolean",
+    provenance: "mega",
+    description: "Return to the station when rain is detected (DP 101, rain_auto_return). Read-only."
+  },
+  /** Wi-Fi signal strength as a percentage (DP 109, `wifi_signal_strength`), not a dBm reading. */
+  wifiSignal: {
+    param: MOWER_DP.WIFI_SIGNAL,
+    type: "number",
+    unit: "%",
+    kind: "percent",
+    provenance: "mega",
+    description: "Wi-Fi signal strength 0-100 % (DP 109, wifi_signal_strength). Read-only."
+  },
+  /** Cutting height in millimetres (DP 110, `mow_height`), 25-75. */
+  cutHeight: {
+    param: MOWER_DP.MOW_HEIGHT,
+    type: "number",
+    unit: "mm",
+    kind: "millimetres",
+    min: 25,
+    max: 75,
+    provenance: "mega",
+    description: "Cutting height 25-75 mm (DP 110, mow_height). Read-only."
+  },
+  /** Progress of saving the map (DP 118, `save_map_process`). */
+  mapSaveProgress: {
+    param: MOWER_DP.SAVE_MAP_PROGRESS,
+    type: "number",
+    unit: "%",
+    kind: "percent",
+    provenance: "mega",
+    description: "Map-save progress 0-100 % (DP 118, save_map_process). Read-only."
+  },
+  /** Total base-station use in minutes (DP 125, `base_station_used_time`). */
+  stationUsedTime: {
+    param: MOWER_DP.STATION_USED_TIME,
+    type: "number",
+    unit: "min",
+    kind: "minutes",
+    provenance: "mega",
+    description: "Base-station use in minutes (DP 125, base_station_used_time). Read-only."
+  },
+  /** Total cutting-blade use in minutes (DP 126, `mow_blade_used_time`). */
+  bladeUsedTime: {
+    param: MOWER_DP.BLADE_USED_TIME,
+    type: "number",
+    unit: "min",
+    kind: "minutes",
+    provenance: "mega",
+    description: "Cutting-blade use in minutes (DP 126, mow_blade_used_time). Read-only."
+  },
+  /** Whether edge trimming is on (DP 128, `edge_trim`). */
+  edgeTrim: {
+    param: MOWER_DP.EDGE_TRIM,
+    type: "bool",
+    kind: "boolean",
+    provenance: "mega",
+    description: "Edge trimming on (DP 128, edge_trim). Read-only."
+  },
+  /** Whether a fixed mowing angle is in use (DP 130, `enable_work_angle`); the angle is `workAngle`. */
+  workAngleEnabled: {
+    param: MOWER_DP.WORK_ANGLE_ENABLED,
+    type: "bool",
+    kind: "boolean",
+    provenance: "mega",
+    description: "Fixed mowing angle in use (DP 130, enable_work_angle). Read-only."
+  },
+  /** The mowing angle in degrees, -90 to 90 (DP 131, `work_angle`). */
+  workAngle: {
+    param: MOWER_DP.WORK_ANGLE,
+    type: "number",
+    unit: "\xB0",
+    kind: "degrees",
+    min: -90,
+    max: 90,
+    provenance: "mega",
+    description: "Mowing angle -90 to 90 degrees (DP 131, work_angle). Read-only."
+  },
+  /** Whether smart no-go zones are on (DP 132, `enable_smart_forbid_zone`). */
+  smartNoGoZones: {
+    param: MOWER_DP.SMART_NO_GO_ZONES,
+    type: "bool",
+    kind: "boolean",
+    provenance: "mega",
+    description: "Smart no-go zones on (DP 132, enable_smart_forbid_zone). Read-only."
+  },
+  /** Whether bird's-eye-view capture is on (DP 133, `enable_bird_view_capture`). */
+  birdViewCapture: {
+    param: MOWER_DP.BIRD_VIEW_CAPTURE,
+    type: "bool",
+    kind: "boolean",
+    provenance: "mega",
+    description: "Bird's-eye-view capture on (DP 133, enable_bird_view_capture). Read-only."
+  },
+  /**
+   * The network link in use (DP 134, `net_media_type`). Answers `undefined` for a value outside the
+   * schema's range.
+   */
+  network: {
+    param: MOWER_DP.NETWORK,
+    type: "string",
+    provenance: "mega",
+    decode: (raw) => typeof raw === "string" && MOWER_NETWORKS.includes(raw) ? raw : void 0,
+    decodedKind: "enum",
+    decodedValues: MOWER_NETWORKS,
+    description: "Network link: None, Wifi or Cellular (DP 134, net_media_type). Read-only."
+  },
+  /** Whether the cellular link is enabled (DP 137, `enable_cellular`). */
+  cellularEnabled: {
+    param: MOWER_DP.CELLULAR_ENABLED,
+    type: "bool",
+    kind: "boolean",
+    provenance: "mega",
+    description: "Cellular link enabled (DP 137, enable_cellular). Read-only."
+  },
+  /** Edge-following distance in millimetres (DP 139, `follow_edge_distance`), signed. */
+  edgeDistance: {
+    param: MOWER_DP.EDGE_DISTANCE,
+    type: "number",
+    unit: "mm",
+    kind: "millimetres",
+    min: -1e4,
+    max: 1e4,
+    provenance: "mega",
+    description: "Edge-following distance in mm, signed (DP 139, follow_edge_distance). Read-only."
+  },
+  /** Whether GPS anti-theft is on (DP 140, `gps_location_check`). */
+  gpsAntiTheft: {
+    param: MOWER_DP.GPS_ANTI_THEFT,
+    type: "bool",
+    kind: "boolean",
+    provenance: "mega",
+    description: "GPS anti-theft on (DP 140, gps_location_check). Read-only."
+  },
+  /** Whether sparse-lawn optimisation is on (DP 141, `sparse_lawn_optimization`). */
+  sparseLawnOptimization: {
+    param: MOWER_DP.SPARSE_LAWN_OPTIMIZATION,
+    type: "bool",
+    kind: "boolean",
+    provenance: "mega",
+    description: "Sparse-lawn optimisation on (DP 141, sparse_lawn_optimization). Read-only."
+  }
+};
+var MOWER_DP_IDS = Object.values(MOWER_DP);
+var MOWER = {
+  capability: "mower",
+  line: "clean",
+  description: "Robot-mower state: battery, cutting height, settings and wear timers (read-only).",
+  members: MOWER_MEMBERS,
+  properties: propertiesOf(MOWER_MEMBERS),
+  /**
+   * The T2880 (E15) only: its Tuya product schema and a live report are the evidence for every member.
+   * The E18 and C15 share the `mower` codec but neither has a schema or a report in hand.
+   */
+  detection: { detect: (record, codec) => codec === "mower" && record.model === "T2880" },
+  decodeState(signal) {
+    const params = pickDpParams(signal.source === "mqtt" ? signal.dpParams : void 0, MOWER_DP_IDS);
+    return params ? { params } : null;
+  }
+};
+
 // dist/model/capabilities/dp-catalog.js
 var EMPTY_DP_CATALOG = {
   enumRanges: /* @__PURE__ */ new Map()
@@ -10918,6 +11135,7 @@ var MODULES = [
   VACUUM_CLEAN,
   VACUUM_DOCK,
   SUCTION,
+  MOWER,
   LOCATE,
   DISPLAY,
   INFO
@@ -13131,6 +13349,103 @@ var DISPLAY_PARAMS = {
     provenance: "mega"
   }
 };
+var MOWER_PARAMS = {
+  8: {
+    name: "battery",
+    type: "number",
+    provenance: "mega"
+  },
+  26: {
+    name: "volume",
+    type: "number",
+    provenance: "mega"
+  },
+  47: {
+    name: "childLock",
+    type: "bool",
+    provenance: "mega"
+  },
+  101: {
+    name: "rainAutoReturn",
+    type: "bool",
+    provenance: "mega"
+  },
+  109: {
+    name: "wifiSignal",
+    type: "number",
+    provenance: "mega"
+  },
+  110: {
+    name: "cutHeight",
+    type: "number",
+    provenance: "mega"
+  },
+  118: {
+    name: "mapSaveProgress",
+    type: "number",
+    provenance: "mega"
+  },
+  125: {
+    name: "stationUsedTime",
+    type: "number",
+    provenance: "mega"
+  },
+  126: {
+    name: "bladeUsedTime",
+    type: "number",
+    provenance: "mega"
+  },
+  128: {
+    name: "edgeTrim",
+    type: "bool",
+    provenance: "mega"
+  },
+  130: {
+    name: "workAngleEnabled",
+    type: "bool",
+    provenance: "mega"
+  },
+  131: {
+    name: "workAngle",
+    type: "number",
+    provenance: "mega"
+  },
+  132: {
+    name: "smartNoGoZones",
+    type: "bool",
+    provenance: "mega"
+  },
+  133: {
+    name: "birdViewCapture",
+    type: "bool",
+    provenance: "mega"
+  },
+  134: {
+    name: "network",
+    type: "string",
+    provenance: "mega"
+  },
+  137: {
+    name: "cellularEnabled",
+    type: "bool",
+    provenance: "mega"
+  },
+  139: {
+    name: "edgeDistance",
+    type: "number",
+    provenance: "mega"
+  },
+  140: {
+    name: "gpsAntiTheft",
+    type: "bool",
+    provenance: "mega"
+  },
+  141: {
+    name: "sparseLawnOptimization",
+    type: "bool",
+    provenance: "mega"
+  }
+};
 
 // dist/model/life-params.js
 var LIFE_PARAMS = {
@@ -13154,6 +13469,8 @@ var LIFE_PARAMS = {
 var TABLES = {
   security: SECURITY_PARAMS,
   clean: CLEAN_PARAMS,
+  // Robot mowers — their own Tuya DP space, so an id stays unnamed rather than reading as a vacuum's.
+  mower: MOWER_PARAMS,
   life: LIFE_PARAMS,
   // 3D-printer (ankermake) id space — empty until a live capture confirms the param↔semantic map
   // (printer-support plan Stage 3). Present so the printer codec resolves to its OWN namespace rather
@@ -13173,7 +13490,7 @@ var NAMESPACE_BY_CODEC = {
   lock: "security",
   keypad: "security",
   vacuum: "clean",
-  mower: "clean",
+  mower: "mower",
   light: "life",
   printer: "print",
   display: "display"
@@ -25743,33 +26060,6 @@ function parseTuyaDpEvent(payload) {
   }
   return Object.keys(result).length > 0 ? result : null;
 }
-function parseTuyaDpReport(raw) {
-  if (!raw || typeof raw !== "object" || Array.isArray(raw))
-    return void 0;
-  const envelope = raw;
-  const payloadObj = jsonObject(envelope.payload);
-  if (payloadObj) {
-    const data2 = payloadObj.data;
-    if (data2 && typeof data2 === "object" && !Array.isArray(data2)) {
-      const dataObj = data2;
-      const dps = dataObj.dps;
-      if (dps && typeof dps === "object" && !Array.isArray(dps))
-        return dps;
-      const filtered = Object.fromEntries(Object.entries(dataObj).filter(([k]) => /^[1-9]\d*$/.test(k)));
-      return Object.keys(filtered).length > 0 ? filtered : void 0;
-    }
-  }
-  const topDps = envelope.dps;
-  if (topDps && typeof topDps === "object" && !Array.isArray(topDps))
-    return topDps;
-  const data = envelope.data;
-  if (data && typeof data === "object" && !Array.isArray(data)) {
-    const dataDps = data.dps;
-    if (dataDps && typeof dataDps === "object" && !Array.isArray(dataDps))
-      return dataDps;
-  }
-  return void 0;
-}
 var TuyaDpRouter = class {
   listener;
   /** Register the inbound listener. Replaces any previously registered one. */
@@ -29329,16 +29619,6 @@ var EufyMega = class extends EventEmitter13 {
     transport.on("disconnect", (r) => this.emit("disconnect", r));
     transport.on("message", (m) => {
       this.emit("message", m);
-      if (m.deviceSn) {
-        const dev = this.registry.list().find((d) => d.sn === m.deviceSn);
-        if (dev?.category === "eufy_home_tuya") {
-          const dps = parseTuyaDpReport(m.raw);
-          if (dps) {
-            this.tuyaDpRouter.deliver(m.deviceSn, dps);
-            return;
-          }
-        }
-      }
       if (m.deviceSn) {
         const frame = parseBizMapFrame(m.raw);
         if (frame) {
@@ -29372,23 +29652,24 @@ var EufyMega = class extends EventEmitter13 {
    * Subscribe the devices on one credential scope; a failing subscribe is reported, not fatal (one
    * unreachable device must not stop the rest of the roster from coming up).
    *
-   * A Tuya clean-line device's DPs are also read from the Tuya cloud, whether or not its subscribe
-   * succeeded: the cloud read is a separate plane, and the broker can refuse a subscribe for a device
-   * whose DPs the Tuya cloud still serves.
+   * A Tuya clean-line device (`eufy_home_tuya`) is not subscribed: its state lives on the Tuya cloud,
+   * and the broker refuses its `eufy_home` topics on every credential. Its DPs are read from the Tuya
+   * cloud instead.
    */
   async subscribeMqttDevices(scope, transport) {
     for (const d of this.getMqttDevices().filter((dev) => mqttScopeFor(dev) === scope)) {
-      try {
-        await transport.subscribeDevice(d);
-        await this.sendRealtimeInit(d.sn);
-      } catch (e) {
-        this.reportError(e);
-      }
       if (d.category === "eufy_home_tuya") {
         this.tuya.fetchDps(d.sn).then((dps) => {
           if (dps)
             this.tuyaDpRouter.deliver(d.sn, dps);
         }).catch((e) => this.reportError(e));
+        continue;
+      }
+      try {
+        await transport.subscribeDevice(d);
+        await this.sendRealtimeInit(d.sn);
+      } catch (e) {
+        this.reportError(e);
       }
     }
   }
@@ -30938,6 +31219,7 @@ export {
   MODEL_REGISTRY,
   MOP_LEVELS,
   MOTION_MEMBERS,
+  MOWER_MEMBERS,
   McsParser,
   MegaApiError,
   MegaHttpClient,