@mega-yfue/eufy-sdk 0.2.0-beta.5 → 0.2.0-beta.7

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

@@ -0,0 +1,85 @@
+import type { CapabilityModule } from "./types.js";
+import { type Surface } from "./members.js";
+/**
+ * `display` — a eufy Smart Display's charge.
+ *
+ * One typed read, and the smallness is the finding rather than a gap. The captured unit (a T87A0,
+ * 2026-09-04) connects over secure MQTT with no `p2p_did`, so it speaks no P2P at all, and it reported
+ * six params in an id range no other line uses. Only one of them tells a caller something it could not
+ * get another way:
+ *
+ *  - 8005 and 8006 restate the model's retail name and code, which `info` already answers from the
+ *    curated registry and the cloud record. Their evidence IS that agreement, so a getter beside `info`
+ *    would offer a caller a second spelling of what it just read. They are named in the display param
+ *    dictionary, which is what makes them readable off `getProperties()`.
+ *  - 8003 is version-shaped and nothing confirms what it means, so it is `unexposed`: in the schema with
+ *    its type and its `guessed` label, reachable through `getProperty`, no typed getter.
+ *
+ * Nothing is writable. No capture pins a write for any display param, and an AIoT write is
+ * fire-and-forget, so a wrong frame to a device that acknowledges nothing looks exactly like success. A
+ * screen, a volume, an assistant: the device plainly has all three and reports none of them in anything
+ * captured, which means the reads have to arrive before a control can be honest about what it moves.
+ *
+ * @module model/capabilities/display
+ */
+/** Smart Display param ids this capability reads. The rest of the range is named in the dictionary. */
+export declare const DISPLAY_PARAM: {
+    readonly BATTERY: 8001;
+    readonly SOFTWARE_VERSION: 8003;
+};
+/**
+ * The `display` reads. Read-only; see the module note for why there is no write.
+ *
+ * Exported but NOT published: the entries state their wire ids and what each claim rests on, which the
+ * reference site does not carry.
+ * @internal
+ */
+export declare const DISPLAY_MEMBERS: {
+    /**
+     * Battery level, 0-100.
+     *
+     * **On this capability rather than on `battery`, and that is the line partition doing its job.** The
+     * security-line `battery` capability reads param 1101 and a Smart Display's charge is 8001 in its own
+     * id space — two wires that happen to mean the same thing. One capability reading both would be a claim
+     * that the two ecosystems share a param space, so a consumer reads a display's charge through
+     * `dev.display()` and a camera's through `dev.battery()`.
+     *
+     * `verified` rather than `mega`: the id is in the device's cloud record, but the NAME came from the
+     * maintainer's own knowledge of the hardware rather than from the cloud data-point list, and `"100"`
+     * fits brightness, volume or charge equally.
+     *
+     * The scale is `percent` on the reading itself, not on convention alone: a full charge reads `255` on a
+     * 0-255 scale and `1000` on a 0-1000 one, so `"100"` on a charged unit is positive evidence for 0-100
+     * rather than merely consistent with it. What nobody has done is watch it MOVE, which is why a value
+     * frozen at 100 would not yet be distinguishable from a healthy one.
+     */
+    readonly battery: {
+        readonly param: 8001;
+        readonly type: "number";
+        readonly unit: "%";
+        readonly kind: "percent";
+        readonly provenance: "verified";
+        readonly description: "Battery level, 0-100 (param 8001).";
+    };
+    /**
+     * Version-shaped, and that shape is the whole of the evidence — hence `guessed`, and hence no typed
+     * getter: a caller reading this off a bound object cannot see the label.
+     *
+     * `unexposed` rather than absent, so the schema still carries its type and that label and
+     * `getProperty("softwareVersion")` still answers. `dev.info()?.firmwareVersion` is the field to trust
+     * where the cloud record carries one; on this display it does not, which is the only reason 8003 is
+     * named at all.
+     */
+    readonly softwareVersion: {
+        readonly param: 8003;
+        readonly type: "string";
+        readonly kind: "text";
+        readonly provenance: "guessed";
+        readonly unexposed: true;
+        readonly description: "Version-shaped string (param 8003), meaning unconfirmed — prefer `info.firmwareVersion`.";
+    };
+};
+/** `display` — a eufy Smart Display (T87Ax). Read-only; no display write is captured. */
+export declare const DISPLAY: CapabilityModule;
+/** Bound Smart Display reads — the object returned by `dev.display()`. Read-only. */
+export type DisplayActions = Surface<typeof DISPLAY_MEMBERS>;

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

@@ -40,6 +40,7 @@ import type { KeypadActions } from "./keypad.js";
 import type { RtspActions } from "./rtsp.js";
 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 { LocateActions } from "./locate.js";
 import type { DeviceInfo } from "./info.js";
@@ -411,6 +412,8 @@ export interface DeviceActionMap {
     suction: SuctionActions;
     /** RoboVac locate (find-robot beep): `locating`; `locate(on?)`. */
     locate: LocateActions;
+    /** Smart Display (read-only): `battery`. No display write is captured. */
+    display: DisplayActions;
     /** Identity metadata (read-only): `{ manufacturer, model, serialNumber, name, deviceType?, firmwareVersion?, hardwareVersion? }`. */
     info: DeviceInfo;
 }
@@ -529,6 +532,7 @@ export { RTSP_MEMBERS } from "./rtsp.js";
 export { SIREN_MEMBERS } from "./siren.js";
 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 { VACUUM_CLEAN_MEMBERS } from "./vacuum-clean.js";
 export type { DeviceInfo } from "./info.js";

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

@@ -41,12 +41,19 @@ export interface DetectionSpec {
  *
  * eufy ships several ecosystems that share a cloud account and nothing else: `security` (cameras,
  * stations, locks, sensors — P2P plus the security-scoped broker), `life` (the T8L0x smart-lighting
- * line — its own credential and its own DP wire), and `clean` (robot vacuums — Tuya data points).
+ * line — its own credential and its own DP wire), `clean` (robot vacuums — Tuya data points) and
+ * `display` (the T87Ax Smart Display — secure MQTT, never P2P, its own 8001-8006 param space).
  * They overlap in retail vocabulary but share no wire, no param space and no semantics.
  *
+ * `display` is a line of its own for the second of those reasons rather than the first: without it,
+ * every security capability detected by a NAME regex is attachable to a Smart Display — measured at six,
+ * on a device that can answer for none of them because it speaks no P2P at all. A line holding one
+ * capability still buys that, which is why the count is not the measure of whether a line is worth
+ * declaring.
+ *
  * `any` is for the handful of capabilities that are genuinely line-independent (device identity).
  */
-export type ProductLine = "security" | "life" | "clean" | "print" | "any";
+export type ProductLine = "security" | "life" | "clean" | "print" | "display" | "any";
 /**
  * A structural subset of a P2P frame. Deliberately NOT `import`ed from `p2p/*` — keeping it
  * structural avoids a model→p2p cycle, and the real `P2PFrame` is assignable to it. It is the

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

@@ -26,3 +26,27 @@ export interface ParamDef {
 export declare const SECURITY_PARAMS: Record<number, ParamDef>;
 /** RoboVac Tuya DP space (ids ~150-180), from get_product_data_point. */
 export declare const CLEAN_PARAMS: Record<number, ParamDef>;
+/**
+ * eufy Smart Display (T87Ax) param space — ids 8001-8006.
+ *
+ * Its own table rather than a corner of {@link SECURITY_PARAMS}: nothing in the 8000s carries a security
+ * meaning, so reading these ids there would decode a future security param assigned in this range as
+ * whatever it means on a camera.
+ *
+ * Every id here was reported by a live T87A0 (captured 2026-09-04). That the device SENT an id is what
+ * earns it a place in this table; the provenance label beside each one rates something narrower — how far
+ * its NAME is trusted. `modelName` and `modelCode` are `mega`, their values matching what the cloud
+ * record already carried. `battery` is `verified`: the id is real and the reading consistent, but the
+ * name came from the maintainer's own knowledge of the hardware rather than from the cloud data-point
+ * list, and `"100"` fits brightness, volume or charge equally.
+ *
+ * A dictionary entry is what makes a param readable by name off `getProperties()`. `capabilities/display.ts`
+ * decides separately which of them reach the typed surface, and only `battery` does.
+ *
+ * **8002 (`"1"`) and 8004 (a serial-shaped string) are absent, deliberately.** Neither meaning is
+ * legible from one value: `1` fits any enum or flag, and a serial could be the display's own or the
+ * station's it is bound to. They arrive as `unknown_8002` / `unknown_8004`, which is the measure of this
+ * list: it holds what is unknown, not what is unknowable. What would settle them: the vendor app's own
+ * display settings screen, one control at a time, params diffed after each.
+ */
+export declare const DISPLAY_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";
+export type ParamNamespace = "security" | "clean" | "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

@@ -28,10 +28,10 @@
  *
  * `display` is the T87Ax Smart Display line — its own codec because its `device_type` collides with
  * the security residual range (confirmed live, 2026-09-04: it connects over secure MQTT with no
- * `p2p_did`, never P2P). Its param namespace and product line are nonetheless grouped into `security`
- * by maintainer decision, not wire evidence — see {@link namespaceForCodec}. No capability module
- * targets it yet: no screen/audio/assistant param has been observed, only its own small cloud-param
- * namespace (ids 8001-8006).
+ * `p2p_did`, never P2P). It owns its own param namespace (ids 8001-8006) and its own product line, so
+ * no other line's capability can attach to it — see `namespaceForCodec` and `CODEC_LINE`. The `display`
+ * capability targets it and reads the charge; no screen/audio/assistant param has been observed, so
+ * those are absent rather than deferred.
  */
 export type Codec = "station" | "camera" | "sensor" | "lock" | "keypad" | "vacuum" | "mower" | "light" | "printer" | "display";
 /**
@@ -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" | "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" | "smart_light" | "display" | "info";
 /** Value type of a property. */
 export type PropertyValueType = "bool" | "number" | "string" | "enum";
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mega-yfue/eufy-sdk",
-  "version": "0.2.0-beta.5",
+  "version": "0.2.0-beta.7",
   "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",