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

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"
@@ -30902,6 +31219,7 @@ export {
   MODEL_REGISTRY,
   MOP_LEVELS,
   MOTION_MEMBERS,
+  MOWER_MEMBERS,
   McsParser,
   MegaApiError,
   MegaHttpClient,