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

package/dist/index.js

@@ -9865,6 +9865,70 @@ function toNumberArray(arr) {
   return result;
 }
 
+// dist/model/capabilities/display.js
+var DISPLAY_PARAM = { BATTERY: 8001, SOFTWARE_VERSION: 8003 };
+var 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.
+   */
+  battery: {
+    param: DISPLAY_PARAM.BATTERY,
+    type: "number",
+    unit: "%",
+    kind: "percent",
+    provenance: "verified",
+    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.
+   */
+  softwareVersion: {
+    param: DISPLAY_PARAM.SOFTWARE_VERSION,
+    type: "string",
+    kind: "text",
+    provenance: "guessed",
+    unexposed: true,
+    description: "Version-shaped string (param 8003), meaning unconfirmed \u2014 prefer `info.firmwareVersion`."
+  }
+};
+var DISPLAY = {
+  capability: "display",
+  line: "display",
+  description: "Smart Display battery level (param 8001, display namespace).",
+  members: DISPLAY_MEMBERS,
+  properties: propertiesOf(DISPLAY_MEMBERS),
+  /**
+   * Claimed by CODEC, not by an evidence param.
+   *
+   * 8001 is in the device's cloud record, so the ordinary evidence gate would install the getter anyway
+   * — but the capability should attach to a Smart Display that has reported nothing yet too, because a
+   * device on this line has no other capability to carry it. The line partition keeps this off
+   * everything else: `display` is the only codec in the `display` line.
+   */
+  detection: { codecs: ["display"] }
+};
+
 // dist/model/capabilities/locate.js
 var LOCATE_DP = 160;
 var LEGACY_LOCATE_DP = TUYA_VACUUM_DP.LOOK_FOR_SWEEPER;
@@ -9993,6 +10057,7 @@ var MODULES = [
   VACUUM_DOCK,
   SUCTION,
   LOCATE,
+  DISPLAY,
   INFO
 ];
 var BY_CAP = new Map(MODULES.map((m) => [m.capability, m]));
@@ -10037,7 +10102,7 @@ var CODEC_LINE = {
   mower: "clean",
   light: "life",
   printer: "print",
-  display: "security"
+  display: "display"
 };
 function lineAllows(module, codec) {
   const line = module.line ?? "security";
@@ -12137,6 +12202,28 @@ var CLEAN_PARAMS = {
     provenance: "mega"
   }
 };
+var DISPLAY_PARAMS = {
+  8001: {
+    name: "battery",
+    type: "number",
+    provenance: "verified"
+  },
+  8003: {
+    name: "softwareVersion",
+    type: "string",
+    provenance: "guessed"
+  },
+  8005: {
+    name: "modelName",
+    type: "string",
+    provenance: "mega"
+  },
+  8006: {
+    name: "modelCode",
+    type: "string",
+    provenance: "mega"
+  }
+};
 
 // dist/model/life-params.js
 var LIFE_PARAMS = {
@@ -12164,7 +12251,10 @@ var TABLES = {
   // 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
   // than falling through to `security` and decoding another line's dictionary.
-  print: {}
+  print: {},
+  // Smart Display (T87Ax) — ids 8001-8006, four of them named. Same reason as `print`: its own
+  // dictionary rather than a corner of another line's.
+  display: DISPLAY_PARAMS
 };
 function paramDef(ns, paramType) {
   return TABLES[ns][paramType];
@@ -12179,7 +12269,7 @@ var NAMESPACE_BY_CODEC = {
   mower: "clean",
   light: "life",
   printer: "print",
-  display: "security"
+  display: "display"
 };
 function namespaceForCodec(codec) {
   return NAMESPACE_BY_CODEC[codec];
@@ -25541,6 +25631,7 @@ export {
   CusPushEvent,
   CusPushMode,
   DEFAULT_KEEPALIVE_MS,
+  DISPLAY_MEMBERS,
   DOCK_ACTIVITIES,
   DOCK_KINDS,
   DOORBELL_MEMBERS,