@mega-yfue/eufy-sdk 0.5.0-beta.9 → 0.5.0-beta.90

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

@@ -182,6 +182,11 @@ export interface AiDetectFlags {
 export declare function encodeAiDetectType(flags: AiDetectFlags): number;
 /** Decode an `ai_detect_type` bitmask → which detection types are on. */
 export declare function decodeAiDetectType(value: number): AiDetectFlags;
+/**
+ * The `ai_detect_type` bitmask from a stored 1298 value: the bare number, or the numeric
+ * `ai_detect_type` field of the JSON object form. Answers `undefined` for any other shape.
+ */
+declare function decodeAiDetectTypeParam(raw: unknown): number | undefined;
 /**
  * Decode a `radar_wd_switch` (2706, loitering) read the way the app does:
  * `typeof v === "object" ? v.radar_wd_switch : v`. The device may store it as a JSON object
@@ -245,11 +250,15 @@ export declare const MOTION_MEMBERS: {
      * 1298 holds the detailed AI-type BITMASK (live-observed: `0x30000` enabled-base | type bits, e.g. a
      * T8425 reads `0x3000f`). Cams also report 1299 (`hbAiDetectType`) but that is a separate, simpler
      * value (1) — NOT this bitmask, so 1298 is the read/write id.
+     *
+     * The value arrives in two shapes, both read by the app's 1298 parser: a bare bitmask, or a JSON
+     * object carrying the same bitmask as `ai_detect_type` (see {@link decodeAiDetectTypeParam}).
      */
     readonly aiDetectType: {
         readonly param: 1298;
-        readonly type: "number";
-        readonly kind: "bitfield";
+        readonly type: "string";
+        readonly decode: typeof decodeAiDetectTypeParam;
+        readonly decodedKind: "bitfield";
         readonly provenance: "verified";
         readonly description: string;
         readonly write: (v: string | number | boolean, ctx: CommandContext) => Command | undefined;
@@ -271,6 +280,10 @@ export declare const MOTION_MEMBERS: {
      * The raw sensitivity an indoor camera reports, on the one id whose write takes a `1700` control
      * payload carrying an index rather than the `1350` envelope its siblings use — a frame-shape
      * difference `sensitivityCommand` resolves from the scale. `unexposed` like its three siblings.
+     *
+     * Some devices report 6041 as a base64 JSON list of per-sensor entries
+     * (`{"list":[{"sensor_id":…,"sensitivity":…}]}`) rather than a scalar. That value is stored verbatim
+     * and this getter answers `undefined` for it: only the scalar form is confirmed to be this step.
      */
     readonly indoorSensitivity: {
         readonly param: 6041;
@@ -279,6 +292,7 @@ export declare const MOTION_MEMBERS: {
         readonly provenance: "verified";
         readonly unexposed: true;
         readonly description: "Raw sensitivity an indoor camera reports (verified: param 6041).";
+        readonly decode: (raw: unknown) => number | undefined;
     };
     /**
      * The raw sensitivity on the INVERTED seven-step camera scale — a HIGHER number is LESS sensitive, so
@@ -374,3 +388,4 @@ export declare const MOTION_MEMBERS: {
     };
 };
 export declare const MOTION: CapabilityModule;
+export {};

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/capabilities/rtsp.d.ts

@@ -1,6 +1,6 @@
 import type { Command } from "../../core/contracts.js";
 import { type Surface } from "./members.js";
-import type { CapabilityModule, CommandContext } from "./types.js";
+import type { AvailabilityContext, CapabilityModule, CommandContext } from "./types.js";
 /** The state params this capability owns — its OWN vocabulary, used by no other capability. */
 export declare const RTSP_PARAM: {
     /**
@@ -93,6 +93,13 @@ export type RtspRecordingModeValue = (typeof RtspRecordingMode)[keyof typeof Rts
  * and the served effect on each endpoint with an RTSP `DESCRIBE`: 401 = challenged, 200 = open.
  */
 export type RtspActions = Surface<typeof RTSP_MEMBERS>;
+/**
+ * Whether the publish switch has a wire to this camera. A HomeBase S1 Pro (`STATION_9000`) carries an
+ * attached camera's commands over its WebRTC control channel, which takes only the `1350` and `1700`
+ * envelopes; the switch is a plain scalar, and no other frame for it is captured there. Gating the
+ * `published` member drops its read with its setter, since one availability decision covers both.
+ */
+declare function publishable(ctx: AvailabilityContext): boolean;
 /**
  * Every `rtsp` feature, declared once.
  *
@@ -127,6 +134,7 @@ export declare const RTSP_MEMBERS: {
             readonly publish: true;
             readonly withdraw: false;
         };
+        readonly available: typeof publishable;
     };
     /**
      * The device-reported RTSP URL — the full `rtsp://user:pass@host/path`, carrying the credentials the
@@ -179,9 +187,13 @@ export declare const RTSP_MEMBERS: {
         readonly description: string;
     };
     /** Persistently publish this camera's stream. The enabling caller owns withdrawing it when done. */
-    readonly publish: import("./members.js").MethodMember<() => Promise<void>>;
+    readonly publish: import("./members.js").MethodMember<() => Promise<void>> & {
+        available: (ctx: CommandContext) => boolean;
+    };
     /** Withdraw this camera's persistent publication; consumer retries do not ask the SDK to republish it. */
-    readonly withdraw: import("./members.js").MethodMember<() => Promise<void>>;
+    readonly withdraw: import("./members.js").MethodMember<() => Promise<void>> & {
+        available: (ctx: CommandContext) => boolean;
+    };
     /**
      * Store credentials and request authentication on this camera's stream. Served enforcement is
      * topology-dependent and must be verified with `DESCRIBE` (401 = challenged, 200 = open).
@@ -219,3 +231,4 @@ export declare const RTSP_MEMBERS: {
  * rather than a model table.
  */
 export declare const RTSP: CapabilityModule;
+export {};

package/dist/model/capabilities/smart-drop.d.ts

@@ -0,0 +1,20 @@
+import { type Surface } from "./members.js";
+import type { CapabilityModule } from "./types.js";
+/**
+ * Every `smart_drop` feature, declared once.
+ *
+ * Exported but NOT published: each entry states its wire id and the evidence it was confirmed on,
+ * which the reference site does not carry.
+ * @internal
+ */
+export declare const SMART_DROP_MEMBERS: {
+    /**
+     * Opens the lid with `SET_PAYLOAD` 2100 at level 2. Verified on a standalone T8790, whose cipher has
+     * only an RSA key: the frame sealed AES-128-ECB opened the lid, the same frame at level 1 did not.
+     */
+    readonly openLid: import("./members.js").MethodMember<() => Promise<void>>;
+};
+/** Bound SmartDrop controls — the object returned by `dev.smartDrop()`. */
+export type SmartDropActions = Surface<typeof SMART_DROP_MEMBERS>;
+/** `smart_drop` — a standalone SmartDrop (T8790) parcel box: open the lid. */
+export declare const SMART_DROP: CapabilityModule;

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

@@ -15,7 +15,7 @@ export declare const SUCTION_DP: {
  * Suction levels — the app's `SuctionEnum` (`getSuctionEnumByValue`). This is a **fixed** value→label
  * map with **no model argument**: a given int means the same thing on every RoboVac. What varies per
  * model is only **availability** — a device's `get_product_data_point` range may expose a narrower
- * subset (the T2351 catalog lists 0-3) — so the `suction` property stays a raw int rather than being
+ * subset (the T2351 catalog lists `Quiet`–`Max`) — so the `suction` property stays a raw int rather than being
  * constrained per device, and {@link suctionLevelName} names a reported level.
  *
  * `BoostIQ` (4) is a real suction level in this scale. The separate `boostIq`
@@ -45,11 +45,11 @@ export declare function suctionLevelName(value: number): string | undefined;
 export type SuctionActions = Surface<typeof SUCTION_MEMBERS> & {
     /**
      * The suction levels this device supports, sourced from the per-SKU `get_product_data_point` catalog
-     * range for DP 158. Narrower than the full six {@link SuctionLevel} values on many models — a T2351
-     * reports `[0, 1, 2, 3]`.
+     * range for DP 158. Narrower than the full six {@link SuctionLevel} values on many models — a T2351's
+     * catalog lists `Quiet`, `Standard`, `Turbo` and `Max`, which answers `[0, 1, 2, 3]`.
      *
-     * `undefined` when the catalog is absent or does not cover DP 158. Only meaningful on devices where
-     * `setSuctionLevel` is installed (AIoT vacuums).
+     * `undefined` when the catalog is absent, does not cover DP 158, or lists only members outside the
+     * known scale. Only meaningful on devices where `setSuctionLevel` is installed (AIoT vacuums).
      */
     readonly supportedLevels?: readonly SuctionLevelValue[];
 };

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

@@ -60,6 +60,8 @@ export type ProductLine = "security" | "life" | "clean" | "print" | "display" |
  * `p2p-frame` shape of {@link InboundSignal}.
  */
 export interface CapabilityFrame {
+    /** Cloud device type resolved from the reporting station/channel. */
+    deviceType?: number;
     stationSn: string;
     commandId: number;
     channel: number;
@@ -247,8 +249,16 @@ export interface AvailabilityContext {
     homeBaseAttached?: boolean;
     /** Serial of the covering station, when the device record names one. */
     stationSerial?: string;
+    /**
+     * The vendor DeviceType of the station the device hangs off, when it is attached
+     * and the station's record states one. Answers which station family a command addressed to an
+     * attached device is carried through.
+     */
+    stationDeviceType?: number;
 }
 export interface CommandContext extends AvailabilityContext {
+    /** Vendor-formatted timezone reported by the station; never inferred from the host. */
+    timezone?: string;
     /** Device channel (0 for standalone, `device_channel` on a HomeBase). */
     channel: number;
     /** eufy DeviceType, when known. */

package/dist/model/capabilities/vacuum-clean.d.ts

@@ -169,12 +169,11 @@ export declare const TUYA_CLEAN_TYPES: readonly ["Sweep", "SweepMop", "Mop"];
 /** @internal */
 export type TuyaCleanType = (typeof TUYA_CLEAN_TYPES)[number];
 /**
- * `ModeCtrlRequest.method` values for DP 152. Live-verified on T2351: START_AUTO_CLEAN → 0
- * (omitted from the wire when zero), START_GOHOME → 6, PAUSE_TASK → 13.
+ * `ModeCtrlRequest.method` values for DP 152. Live-verified on T2351: START_GOHOME → 6,
+ * PAUSE_TASK → 13. An auto clean is `START_AUTO_CLEAN` (0) with a payload — see
+ * {@link ModeCtrlParamMethod}.
  */
 export declare const ModeCtrlMethod: {
-    /** Live-verified on a T2351. Zero, so it is omitted from the wire per the proto3 default rule. */
-    readonly START_AUTO_CLEAN: 0;
     /** Live-verified on a T2351. */
     readonly START_GOHOME: 6;
     /** Live-verified on a T2351. */
@@ -202,9 +201,11 @@ export declare const ModeCtrlMethod: {
  * its argument in the signature: {@link VACUUM_CLEAN_MEMBERS.startScene},
  * {@link VACUUM_CLEAN_MEMBERS.cleanRooms} and {@link VACUUM_CLEAN_MEMBERS.cleanZones}.
  *
- * The outer frame these ride in is byte-verified on a live T2351, and `SCENE`, `SELECT_ROOMS` and
- * `SELECT_ZONES` have each since been RUN on a T2351 and did what they name — so their numbers rest on
- * observed behaviour rather than on the vendor's definition alone.
+ * The outer frame these ride in is byte-verified on a live T2351, and `AUTO`, `SCENE`, `SELECT_ROOMS`
+ * and `SELECT_ZONES` have each since been RUN on a T2351 and did what they name — so their numbers rest
+ * on observed behaviour rather than on the vendor's definition alone. `AUTO` is RUN with its payload:
+ * the vendor's definition calls `AutoClean.clean_times` valid only when non-zero, and the T2351 did
+ * not start on method 0 sent without it.
  *
  * That distinction is the whole point of checking, and this is the one place it is argued: an AIoT
  * data-point write is fire-and-forget, so a wrong number would be a different command arriving and
@@ -215,6 +216,11 @@ export declare const ModeCtrlMethod: {
  * scene id and a map id both arrive on DP 180.
  */
 export declare const ModeCtrlParamMethod: {
+    /** `START_AUTO_CLEAN` with an `AutoClean` payload — clean the whole floor. */
+    readonly AUTO: {
+        readonly method: 0;
+        readonly param: 3;
+    };
     /** `START_SELECT_ROOMS_CLEAN` — clean the named rooms of a named map. */
     readonly SELECT_ROOMS: {
         readonly method: 1;
@@ -274,17 +280,17 @@ export declare function encodeSelectZonesClean(mapId: number, zones: readonly Va
  * @internal
  */
 export declare function encodeSceneClean(sceneId: number): string;
+/**
+ * Build a whole-floor auto clean carrying an `AutoClean` payload of one pass.
+ * @internal
+ */
+export declare function encodeAutoClean(): string;
 /**
  * Encode a `ModeCtrlRequest` protobuf (DP 152) as a DP value: `varint(bodyLen) ++ {method:1, seq:2}`.
  *
  * Built on {@link RawDpWriter} rather than hand-rolled bytes. The frame is unchanged and the existing
  * byte-level test is what proves it — that test was written against a live T2351 capture, so it holds
  * the writer to the wire rather than to this function's own idea of the wire.
- *
- * Method 0 (START_AUTO_CLEAN) is omitted rather than written as an explicit zero, per the proto3
- * default-field rule and confirmed on that same capture. The writer deliberately does not apply that
- * rule itself: whether an explicit zero and an absent field mean the same thing is the
- * message's business, not the encoder's.
  * @internal
  */
 export declare function encodeModeCtrl(method: number, seq: number): string;
@@ -1955,7 +1961,7 @@ export declare const VACUUM_CLEAN_MEMBERS: {
         readonly provenance: "mega";
         readonly description: "Stop smart-follow mode (ModeCtrlRequest method 18 over DP 152). Method number not captured — unverified.";
     };
-    /** Start an auto-clean run via ModeCtrlRequest method 0 (DP 152). AIoT only — Tuya write unverified. */
+    /** Start an auto-clean run via ModeCtrlRequest method 0 with one `AutoClean` pass (DP 152). AIoT only — Tuya write unverified. */
     readonly startCleaning: import("./members.js").MethodMember<() => Promise<void>> & {
         available: (ctx: import("./types.js").CommandContext) => boolean;
     };

package/dist/model/classify.d.ts

@@ -56,8 +56,7 @@ export declare function codecForType(deviceType: number): Codec | undefined;
  *  - `T74xx` → **lock** (SmartSafe 7400-series).
  *  - `T80xx` / `T8001` / `T8002` / `T8010` / `T8030` / `T8023` / `T8025` → **station**
  *    (HomeBase / HomeBase 2 / 3 / Mini), `T9000` (the app's own model registry files it as family
- *    `STATION_9000`, the one station family outside the T8 band), and `T8N00` (NVR) / `T8E00` (PoE
- *    NVR) → station.
+ *    `STATION_9000`, the one station family outside the T8 band), and `T8N00` (NVR) → station.
  *  - `T89xx` (entry/motion/water/siren sensors, e.g. T8900/T8910/T8920) → **sensor**.
  *  - `T87xx` keypad (`T8960`) → **keypad**.
  *  - any other `T8…` security T-code → **camera** (the default security family).

package/dist/model/device-family.d.ts

@@ -11,6 +11,11 @@ export interface FamilyContext {
      * `"eufy_home_tuya"` devices are on the ThingClips/Tuya Cloud platform, not Anker AIoT MQTT.
      */
     category?: string;
+    /**
+     * Full device serial, when known. The one family split that no type number expresses: the vendor
+     * reuses one DeviceType across generations of a product and distinguishes them by serial.
+     */
+    serial?: string;
 }
 /** Indoor cams, incl. indoor pan/tilt + S350/E30/C-series + mini. */
 export declare const INDOOR_CAMERA_TYPES: ReadonlySet<number>;
@@ -43,6 +48,16 @@ export declare const isOutdoorPanTilt: (ctx: FamilyContext) => boolean;
 export declare const isFloodLight: (ctx: FamilyContext) => boolean;
 /** HomeBase-family hub (has a speaker/alarm) — a station EXCLUDING the NVRs, per `HOMEBASE_TYPES`. */
 export declare const isHomeBase: (ctx: FamilyContext) => boolean;
+/** HomeBase S1 Pro (`STATION_9000`), the station the app drives over its WebRTC control channel. */
+export declare const isStation9000: (ctx: FamilyContext) => boolean;
+/** T8N00 NVR, identified by its reported model. */
+export declare const isNvrT8N00: (ctx: FamilyContext) => boolean;
+/** PoE cameras whose media is served by their NVR's portal call. */
+export declare const isNvrMediaCamera: (ctx: FamilyContext) => boolean;
+/** PoE S4 camera with independently streamed fixed and movable optical views. */
+export declare const isNvrDualLensCamera: (ctx: FamilyContext) => boolean;
+/** Video Doorbell C31 (T8223), identified by its reported model. */
+export declare const isDoorbellT8223: (ctx: FamilyContext) => boolean;
 /** Wired doorbell (DeviceType.DOORBELL). */
 export declare const isWiredDoorbell: (ctx: FamilyContext) => boolean;
 /**
@@ -72,3 +87,12 @@ export declare const isAiotVacuum: (ctx: FamilyContext) => boolean;
  * vacuums receive the same write actions as AIoT ones, routed by the facade's `routeCommand`.
  */
 export declare const isTuyaVacuum: (ctx: FamilyContext) => boolean;
+/** Video Smart Lock S330, identified by its distinct cloud device type. */
+export declare const isVideoSmartLock: (ctx: FamilyContext) => boolean;
+/**
+ * The classic Wi-Fi smart lock — the unit whose actuation rides a per-command ECDH-wrapped key rather than
+ * the shared `ff09` frame: DeviceType 51 with a serial in the `T8520` range whose seventh character is `2`,
+ * the one range driven on hardware. The DeviceType alone does not identify it, since later units share the
+ * number and take the `ff09` frame, and a device whose serial is unknown is not guessed either way.
+ */
+export declare const isClassicWifiLock: (ctx: FamilyContext) => boolean;

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_drop" | "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.
@@ -140,6 +142,11 @@ export interface PropertySpec {
     kind?: ValueKind;
     /** Whether the value can be written back to the device (a setter exists). */
     writable: boolean;
+    /**
+     * Whether the device has reported this value: its own param, a read alias, or the payload it reads
+     * from. `false` means it never has. Absent when the manifest was built without the device's params.
+     */
+    reported?: boolean;
     /** Allowed values for `type: "enum"` (raw → label). */
     enumValues?: Record<number, string>;
     /**
@@ -170,10 +177,11 @@ export interface PropertySpec {
      * consumable counters are `"number"` over one base64 string, and reading the value as a number is
      * exactly what must NOT happen at ingest.
      *
-     * Storage already keeps such a value intact — a non-numeric string cannot be coerced to a number, so
-     * it is passed through. What this flag changes is that the pass-through stops being reported as a
-     * mistake: a robot reporting ten Raw DPs on every push logged ten warnings a time saying its
-     * properties were misdeclared, which is how a real warning goes unread.
+     * Storage keeps such a value intact: a non-numeric string passes a `number` coercion unchanged, and
+     * on a `bool` property a string that is not a boolean wire form (`"0"`, `"1"`, `"true"`, `"false"`)
+     * is kept rather than read as `false`. The pass-through is not reported as a mistake: a robot
+     * reporting ten Raw DPs on every push logged ten warnings a time saying its properties were
+     * misdeclared, which is how a real warning goes unread.
      */
     raw?: true;
     /**

package/dist/transport/abortable.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Settle `work` as it settles, or reject the moment `signal` aborts, whichever comes first.
+ *
+ * The underlying wait is left to finish on its own: it may be shared work other callers are waiting on, so a
+ * caller abandoning its own call does not cancel the work itself. This abandons WAITING, which is the only
+ * part that belonged to the caller.
+ */
+export declare function abortable<T>(work: Promise<T>, signal?: AbortSignal): Promise<T>;