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

package/dist/model/capabilities/index.d.ts

@@ -42,6 +42,7 @@ import type { VacuumCleanActions } from "./vacuum-clean.js";
 import type { VacuumDockActions } from "./vacuum-dock.js";
 import type { DisplayActions } from "./display.js";
 import type { SuctionActions } from "./suction.js";
+import type { MowerActions } from "./mower.js";
 import type { LocateActions } from "./locate.js";
 import type { DeviceInfo } from "./info.js";
 import type { CusPushAlarmType } from "../push-events.js";
@@ -426,6 +427,8 @@ export interface DeviceActionMap {
     vacuumDock: VacuumDockActions;
     /** RoboVac suction: `level`, `boostIq`, `supportedLevels`; `setSuctionLevel`, `setBoostIq`. */
     suction: SuctionActions;
+    /** Robot mower (read-only): `battery`, `cutHeight`, `network`, `wifiSignal`, wear timers and settings. No write is captured. */
+    mower: MowerActions;
     /** RoboVac locate (find-robot beep): `locating`; `locate(on?)`. */
     locate: LocateActions;
     /** Smart Display (read-only): `battery`. No display write is captured. */
@@ -521,7 +524,7 @@ export type { ActionSpec } from "./types.js";
  * `undefined` for an action nothing describes.
  */
 export { actionSpecOf } from "./access.js";
-export type { PtzActions, LightActions, SmartLightActions, RgbColor, CameraActions, LockActions, SirenActions, ArmingActions, BatteryActions, MotionActions, ContactActions, LeakActions, SmokeActions, CoActions, KeypadActions, RtspActions, VacuumCleanActions, SuctionActions, LocateActions, };
+export type { PtzActions, LightActions, SmartLightActions, RgbColor, CameraActions, LockActions, SirenActions, ArmingActions, BatteryActions, MotionActions, ContactActions, LeakActions, SmokeActions, CoActions, KeypadActions, RtspActions, VacuumCleanActions, SuctionActions, MowerActions, LocateActions, };
 /**
  * The member table each `*Actions` type is DERIVED from (`LockActions = Surface<typeof LOCK_MEMBERS>`),
  * so the type names the table and the table is part of the published surface.
@@ -550,6 +553,7 @@ export { SMART_LIGHT_MEMBERS } from "./smart-light.js";
 export { SMOKE_MEMBERS } from "./smoke.js";
 export { DISPLAY_MEMBERS, type DisplayActions } from "./display.js";
 export { SUCTION_MEMBERS } from "./suction.js";
+export { MOWER_MEMBERS } from "./mower.js";
 export { VACUUM_CLEAN_MEMBERS } from "./vacuum-clean.js";
 export type { DeviceInfo } from "./info.js";
 export type { AutoSpotlightOptions } from "./light.js";

package/dist/model/capabilities/mower.d.ts

@@ -0,0 +1,230 @@
+import { type Surface } from "./members.js";
+import type { CapabilityModule } from "./types.js";
+/**
+ * Robot-mower Tuya **DP ids** — the E15's Tuya product schema (`thing.m.device.ref.info.list` v5.4,
+ * `schemaInfo.schema`, product `bvxrcjxom787vnit`), each id also reported by a live E15. The product
+ * is built on Tuya's robot-vacuum template, so ids below 101 carry that template's codes; the mower's
+ * own data points are 101-146.
+ *
+ * Only scalar data points are named here. The Raw ones (`robot_status` 107, `battery_status` 108,
+ * `map_info` 113, the `*_control` commands 103-106, …) are protobuf messages whose field layout no
+ * source in hand states, and 102 (`device_infomation`) and 142 (`gps_info`) carry the device's network
+ * identity and position.
+ * @internal
+ */
+export declare const MOWER_DP: {
+    readonly BATTERY: 8;
+    readonly VOLUME: 26;
+    readonly CHILD_LOCK: 47;
+    readonly RAIN_AUTO_RETURN: 101;
+    readonly WIFI_SIGNAL: 109;
+    readonly MOW_HEIGHT: 110;
+    readonly SAVE_MAP_PROGRESS: 118;
+    readonly STATION_USED_TIME: 125;
+    readonly BLADE_USED_TIME: 126;
+    readonly EDGE_TRIM: 128;
+    readonly WORK_ANGLE_ENABLED: 130;
+    readonly WORK_ANGLE: 131;
+    readonly SMART_NO_GO_ZONES: 132;
+    readonly BIRD_VIEW_CAPTURE: 133;
+    readonly NETWORK: 134;
+    readonly CELLULAR_ENABLED: 137;
+    readonly EDGE_DISTANCE: 139;
+    readonly GPS_ANTI_THEFT: 140;
+    readonly SPARSE_LAWN_OPTIMIZATION: 141;
+};
+/** The `net_media_type` (DP 134) range, as the schema lists it. */
+export declare const MOWER_NETWORKS: readonly ["None", "Wifi", "Cellular"];
+/** The mower's network link (DP 134). */
+export type MowerNetwork = (typeof MOWER_NETWORKS)[number];
+/**
+ * Every `mower` read, declared once.
+ *
+ * All read-only. Several of these data points are `rw` in the schema, but no write has been captured
+ * against a mower, and the vendor app drives the mower through named pass-through commands rather than
+ * by publishing these DPs, so no setter is installed.
+ *
+ * Exported but NOT published: each entry states its wire id, which the reference site does not carry.
+ * @internal
+ */
+export declare const MOWER_MEMBERS: {
+    /** Charge percentage (DP 8, `battery_percentage`). */
+    readonly battery: {
+        readonly param: 8;
+        readonly type: "number";
+        readonly unit: "%";
+        readonly kind: "percent";
+        readonly provenance: "mega";
+        readonly description: "Battery level 0-100 (DP 8, battery_percentage). Read-only.";
+    };
+    /** Speaker volume (DP 26, `volume_set`). */
+    readonly volume: {
+        readonly param: 26;
+        readonly type: "number";
+        readonly unit: "%";
+        readonly kind: "percent";
+        readonly provenance: "mega";
+        readonly description: "Speaker volume 0-100 (DP 26, volume_set). Read-only.";
+    };
+    /** Whether the child lock is on (DP 47, `child_lock`). */
+    readonly childLock: {
+        readonly param: 47;
+        readonly type: "bool";
+        readonly kind: "boolean";
+        readonly provenance: "mega";
+        readonly 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`). */
+    readonly rainAutoReturn: {
+        readonly param: 101;
+        readonly type: "bool";
+        readonly kind: "boolean";
+        readonly provenance: "mega";
+        readonly 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. */
+    readonly wifiSignal: {
+        readonly param: 109;
+        readonly type: "number";
+        readonly unit: "%";
+        readonly kind: "percent";
+        readonly provenance: "mega";
+        readonly description: "Wi-Fi signal strength 0-100 % (DP 109, wifi_signal_strength). Read-only.";
+    };
+    /** Cutting height in millimetres (DP 110, `mow_height`), 25-75. */
+    readonly cutHeight: {
+        readonly param: 110;
+        readonly type: "number";
+        readonly unit: "mm";
+        readonly kind: "millimetres";
+        readonly min: 25;
+        readonly max: 75;
+        readonly provenance: "mega";
+        readonly description: "Cutting height 25-75 mm (DP 110, mow_height). Read-only.";
+    };
+    /** Progress of saving the map (DP 118, `save_map_process`). */
+    readonly mapSaveProgress: {
+        readonly param: 118;
+        readonly type: "number";
+        readonly unit: "%";
+        readonly kind: "percent";
+        readonly provenance: "mega";
+        readonly 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`). */
+    readonly stationUsedTime: {
+        readonly param: 125;
+        readonly type: "number";
+        readonly unit: "min";
+        readonly kind: "minutes";
+        readonly provenance: "mega";
+        readonly 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`). */
+    readonly bladeUsedTime: {
+        readonly param: 126;
+        readonly type: "number";
+        readonly unit: "min";
+        readonly kind: "minutes";
+        readonly provenance: "mega";
+        readonly description: "Cutting-blade use in minutes (DP 126, mow_blade_used_time). Read-only.";
+    };
+    /** Whether edge trimming is on (DP 128, `edge_trim`). */
+    readonly edgeTrim: {
+        readonly param: 128;
+        readonly type: "bool";
+        readonly kind: "boolean";
+        readonly provenance: "mega";
+        readonly 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`. */
+    readonly workAngleEnabled: {
+        readonly param: 130;
+        readonly type: "bool";
+        readonly kind: "boolean";
+        readonly provenance: "mega";
+        readonly 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`). */
+    readonly workAngle: {
+        readonly param: 131;
+        readonly type: "number";
+        readonly unit: "°";
+        readonly kind: "degrees";
+        readonly min: -90;
+        readonly max: 90;
+        readonly provenance: "mega";
+        readonly 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`). */
+    readonly smartNoGoZones: {
+        readonly param: 132;
+        readonly type: "bool";
+        readonly kind: "boolean";
+        readonly provenance: "mega";
+        readonly 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`). */
+    readonly birdViewCapture: {
+        readonly param: 133;
+        readonly type: "bool";
+        readonly kind: "boolean";
+        readonly provenance: "mega";
+        readonly 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.
+     */
+    readonly network: {
+        readonly param: 134;
+        readonly type: "string";
+        readonly provenance: "mega";
+        readonly decode: (raw: unknown) => MowerNetwork | undefined;
+        readonly decodedKind: "enum";
+        readonly decodedValues: readonly ["None", "Wifi", "Cellular"];
+        readonly description: "Network link: None, Wifi or Cellular (DP 134, net_media_type). Read-only.";
+    };
+    /** Whether the cellular link is enabled (DP 137, `enable_cellular`). */
+    readonly cellularEnabled: {
+        readonly param: 137;
+        readonly type: "bool";
+        readonly kind: "boolean";
+        readonly provenance: "mega";
+        readonly description: "Cellular link enabled (DP 137, enable_cellular). Read-only.";
+    };
+    /** Edge-following distance in millimetres (DP 139, `follow_edge_distance`), signed. */
+    readonly edgeDistance: {
+        readonly param: 139;
+        readonly type: "number";
+        readonly unit: "mm";
+        readonly kind: "millimetres";
+        readonly min: -10000;
+        readonly max: 10000;
+        readonly provenance: "mega";
+        readonly 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`). */
+    readonly gpsAntiTheft: {
+        readonly param: 140;
+        readonly type: "bool";
+        readonly kind: "boolean";
+        readonly provenance: "mega";
+        readonly description: "GPS anti-theft on (DP 140, gps_location_check). Read-only.";
+    };
+    /** Whether sparse-lawn optimisation is on (DP 141, `sparse_lawn_optimization`). */
+    readonly sparseLawnOptimization: {
+        readonly param: 141;
+        readonly type: "bool";
+        readonly kind: "boolean";
+        readonly provenance: "mega";
+        readonly description: "Sparse-lawn optimisation on (DP 141, sparse_lawn_optimization). Read-only.";
+    };
+};
+/**
+ * Bound mower reads — the object returned by `dev.mower()`. Each getter is present only once the
+ * mower has reported its data point.
+ */
+export type MowerActions = Surface<typeof MOWER_MEMBERS>;
+/** `mower` — robot-mower state from its Tuya data points. */
+export declare const MOWER: CapabilityModule;

package/dist/model/param-dictionary.d.ts

@@ -9,6 +9,7 @@
  *    `types.ts`.
  *  - CLEAN_PARAMS — RoboVac Tuya DP space (ids 1 and above), names from the cloud
  *    `get_product_data_point` data_point_list, hence provenance `mega`.
+ *  - MOWER_PARAMS — robot-mower Tuya DP space, names from the mower's Tuya product schema.
  *
  * Which models reported an id, and the capture that named it, are in the commit that adds the entry.
  */
@@ -50,3 +51,8 @@ export declare const CLEAN_PARAMS: Record<number, ParamDef>;
  * display settings screen, one control at a time, params diffed after each.
  */
 export declare const DISPLAY_PARAMS: Record<number, ParamDef>;
+/**
+ * Robot-mower Tuya DP space — names from the E15's Tuya product schema (`schemaInfo.schema`), each id
+ * also reported by a live E15. Only the scalar data points the `mower` capability reads are listed.
+ */
+export declare const MOWER_PARAMS: Record<number, ParamDef>;

package/dist/model/param-namespace.d.ts

@@ -14,7 +14,7 @@
 import type { Codec } from "./types.js";
 import { type ParamDef } from "./param-dictionary.js";
 /** The param id spaces this SDK models. */
-export type ParamNamespace = "security" | "clean" | "life" | "print" | "display";
+export type ParamNamespace = "security" | "clean" | "mower" | "life" | "print" | "display";
 /** Look up a param def in the given namespace. */
 export declare function paramDef(ns: ParamNamespace, paramType: number): ParamDef | undefined;
 /** The param namespace a device's ids live in, from its codec, via the module-local `NAMESPACE_BY_CODEC` table. */

package/dist/model/types.d.ts

@@ -39,7 +39,7 @@ export type Codec = "station" | "camera" | "sensor" | "lock" | "keypad" | "vacuu
  * it maps to a {@link CapabilityModule} that owns its property schema. Extend this union as
  * new capabilities are modelled — adding one never requires a subclass.
  */
-export type Capability = "video" | "snapshot" | "motion" | "person_detection" | "battery" | "light" | "ptz" | "doorbell" | "contact" | "leak" | "smoke" | "co" | "siren" | "lock" | "keypad" | "arming" | "storage" | "rtsp" | "camera" | "audio" | "vacuum_clean" | "vacuum_dock" | "suction" | "locate" | "smart_light" | "display" | "info";
+export type Capability = "video" | "snapshot" | "motion" | "person_detection" | "battery" | "light" | "ptz" | "doorbell" | "contact" | "leak" | "smoke" | "co" | "siren" | "lock" | "keypad" | "arming" | "storage" | "rtsp" | "camera" | "audio" | "vacuum_clean" | "vacuum_dock" | "suction" | "locate" | "mower" | "smart_light" | "display" | "info";
 /** Value type of a property. */
 export type PropertyValueType = "bool" | "number" | "string" | "enum";
 /**
@@ -52,11 +52,12 @@ export type PropertyValueType = "bool" | "number" | "string" | "enum";
  * one as the other is wrong in a way no type check catches.
  *
  *  - `boolean` — an on/off state (always paired with `type: "bool"`).
- *  - `percent` / `celsius` / `dbm` / `seconds` / `hours` / `megabytes` / `degrees` — a measured quantity
- *    in the unit the device reports it in; each pairs with the matching `unit`. Values are
- *    never converted on the way out — a converted reading is an invented one. `seconds` and `hours`
- *    are separate kinds for exactly that reason: a robot reports a run in seconds and a consumable's
- *    wear in hours, and normalising one into the other would publish a number the device never sent.
+ *  - `percent` / `celsius` / `dbm` / `seconds` / `hours` / `minutes` / `millimetres` / `megabytes` /
+ *    `degrees` — a measured quantity in the unit the device reports it in; each pairs with the
+ *    matching `unit`. Values are never converted on the way out — a converted reading is an invented
+ *    one. `seconds`, `minutes` and `hours` are separate kinds for exactly that reason: a robot reports
+ *    a run in seconds, a mower its blade wear in minutes and a vacuum's consumable wear in hours, and
+ *    normalising one into another would publish a number the device never sent.
  *  - `scalar` — a plain number in no unit at all: a step on a ladder, a mode index, a raw level, a
  *    segment count. Ordered and comparable, but its range and direction are the device's, so nothing
  *    but the device says what a given value means.
@@ -83,7 +84,7 @@ export type PropertyValueType = "bool" | "number" | "string" | "enum";
  *    decodes them and are exported beside that decoder; unlike an enum's options they are not carried
  *    here, which is a gap this vocabulary does not close on its own.
  */
-export declare const KNOWN_VALUE_KINDS: readonly ["boolean", "percent", "celsius", "dbm", "seconds", "hours", "megabytes", "degrees", "scalar", "bitfield", "enum", "identifier", "timestamp", "text"];
+export declare const KNOWN_VALUE_KINDS: readonly ["boolean", "percent", "celsius", "dbm", "seconds", "hours", "minutes", "millimetres", "megabytes", "degrees", "scalar", "bitfield", "enum", "identifier", "timestamp", "text"];
 /** One of the kinds this version models — the closed half of {@link ValueKind}. */
 export type KnownValueKind = (typeof KNOWN_VALUE_KINDS)[number];
 /**
@@ -106,7 +107,8 @@ export declare function isKnownValueKind(kind: ValueKind): kind is KnownValueKin
 /**
  * How much a param's name and meaning can be trusted, most-trusted first. This is the one definition;
  * the param dictionary and every `provenance` field use it.
- *  - `mega`     — the vendor's cloud names it: its data-point catalog (`get_product_data_point`), or a
+ *  - `mega`     — the vendor's cloud names it: its data-point catalog (`get_product_data_point`), the
+ *                 Tuya product schema of an `eufy_home_tuya` device (`thing.m.device.ref.info.list`), or a
  *                 reported value that matches what the cloud record already says (a model name or code).
  *  - `verified` — confirmed on a real device by this project: our own capture or observation, or
  *                 identified by someone who has the hardware.

package/dist/transport/http/mega-client.d.ts

@@ -230,6 +230,8 @@ export declare class MegaHttpClient {
     /** 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. */
     private pending2fa;
+    /** An autonomous re-login answered captcha/2FA; see {@link canReauthenticate}. */
+    private reloginChallenged;
     private tokenExpiresAt;
     /**
      * Stable per-install device id: `openudid` as configured, as restored from the session store, or as
@@ -265,6 +267,7 @@ export declare class MegaHttpClient {
      *
      * 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
@@ -589,7 +592,9 @@ export declare class MegaHttpClient {
      * 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.
      */
     private canReauthenticate;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mega-yfue/eufy-sdk",
-  "version": "0.5.0-beta.54",
+  "version": "0.5.0-beta.56",
   "description": "One typed TypeScript client for the Anker eufy v6 cloud — capability-driven devices, realtime events over P2P/MQTT/push, and live media",
   "license": "Apache-2.0",
   "author": "mega-yfue",