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

package/dist/index.js

@@ -1605,6 +1605,8 @@ var MegaHttpClient = class {
   /** True while a 2FA code is outstanding: `auth_` holds only the limited pre-verify token, so the
    *  restored-session short-circuit must NOT treat it as a usable session. Cleared on Ok/reset. */
   pending2fa = false;
+  /** An autonomous re-login answered captcha/2FA; see {@link canReauthenticate}. */
+  reloginChallenged = false;
   tokenExpiresAt = 0;
   /**
    * Stable per-install device id: `openudid` as configured, as restored from the session store, or as
@@ -1656,6 +1658,7 @@ var MegaHttpClient = class {
    *
    * Read at construction, and again when a rejection is being recovered from — a store SHARED with another
    * client may already hold the session that client obtained, which is cheaper to adopt than to compete with.
+   * An adopted session is a complete one, so it ends any 2FA or challenged re-login this client was left with.
    *
    * Note: the device identity (openudid + phone model + media UA) is NOT restored here — it is resolved once
    * in the constructor, where an explicit config wins over the stored value, and must not be re-derived from a
@@ -1674,6 +1677,8 @@ var MegaHttpClient = class {
       geoKey: saved.geoKey
     };
     this.tokenExpiresAt = saved.tokenExpiresAt;
+    this.pending2fa = false;
+    this.reloginChallenged = false;
     this.sessionKey = {
       keyIdent: saved.keyIdent,
       shareKey: saved.shareKey,
@@ -2358,11 +2363,13 @@ ${this.auth_?.authToken ?? ""}`;
    * Structural rather than a list of paths: a login round trip is itself an authenticated call while a limited
    * token is held, so re-logging in from inside one would recurse — and a path list would have to be
    * maintained alongside every request the login flow makes. A 2FA code already outstanding is a login a human
-   * is part-way through, and restarting it silently would discard it. No credentials means nothing to try,
+   * is part-way through, and restarting it silently would discard it. A re-login that already came back needing
+   * a captcha or a 2FA code would need the same again, and each attempt sends the account another code, so
+   * none is tried until a login completes or a stored session is adopted. No credentials means nothing to try,
    * so the rejection surfaces instead.
    */
   canReauthenticate() {
-    return !!this.cfg.email && !!this.cfg.password && !this.loggingIn && !this.pending2fa;
+    return !!this.cfg.email && !!this.cfg.password && !this.loggingIn && !this.pending2fa && !this.reloginChallenged;
   }
   /**
    * Replace a rejected token by running the login state machine again, at most once at a time.
@@ -2379,8 +2386,10 @@ ${this.auth_?.authToken ?? ""}`;
     this.reauthAttempt ??= this.login().then((result) => {
       if (result.status === LoginStatus.Ok)
         this.logger.debug("[mega] token was rejected \u2014 logged in again");
-      else
+      else {
+        this.reloginChallenged = true;
         this.logger.warn(`[mega] token was rejected and the re-login needs ${result.status} \u2014 cannot recover`);
+      }
       return result.status === LoginStatus.Ok;
     }).catch((e) => {
       this.logger.warn(`[mega] re-login failed: ${e instanceof Error ? e.message : String(e)}`);
@@ -2457,6 +2466,7 @@ ${this.auth_?.authToken ?? ""}`;
     }
     this.pendingCaptchaId = void 0;
     this.pending2fa = false;
+    this.reloginChallenged = false;
     this.auth_ = { userId, accountUserId, authToken, geoKey };
     this.tokenExpiresAt = reply.tokenExpiresAt;
     this.sessionKey = void 0;
@@ -2963,6 +2973,8 @@ var KNOWN_VALUE_KINDS = [
   "dbm",
   "seconds",
   "hours",
+  "minutes",
+  "millimetres",
   "megabytes",
   "degrees",
   "scalar",
@@ -10663,6 +10675,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 +11145,7 @@ var MODULES = [
   VACUUM_CLEAN,
   VACUUM_DOCK,
   SUCTION,
+  MOWER,
   LOCATE,
   DISPLAY,
   INFO
@@ -13131,6 +13359,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 +13479,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 +13500,7 @@ var NAMESPACE_BY_CODEC = {
   lock: "security",
   keypad: "security",
   vacuum: "clean",
-  mower: "clean",
+  mower: "mower",
   light: "life",
   printer: "print",
   display: "display"
@@ -30902,6 +31229,7 @@ export {
   MODEL_REGISTRY,
   MOP_LEVELS,
   MOTION_MEMBERS,
+  MOWER_MEMBERS,
   McsParser,
   MegaApiError,
   MegaHttpClient,