@mega-yfue/eufy-sdk 0.2.0-beta.21 → 0.2.0-beta.23

package/dist/index.js

@@ -3230,7 +3230,14 @@ function describeBound(modules, bound, ctx) {
       else
         undescribedActions.push(name);
     }
-    out.push({ capability: m.capability, accessor, reads: reads2, actions, undescribedActions, events: emitsOf(m) });
+    out.push({
+      capability: m.capability,
+      accessor,
+      reads: reads2,
+      actions,
+      undescribedActions,
+      events: emitsOf(m, reads2, ctx)
+    });
   }
   return out;
 }
@@ -3249,8 +3256,22 @@ function readDescriptor(name, m, descriptors, ctx) {
     description: m.description
   };
 }
-function emitsOf(m) {
-  return [.../* @__PURE__ */ new Set([...(m.events ?? []).map((e) => e.emit), ...m.emits ?? []])];
+function emitsOf(m, reads2, ctx) {
+  const installed = new Set(reads2.map((r) => r.accessor));
+  const claimed = (m.events ?? []).filter((e) => holds(e.claim, installed, ctx)).map((e) => e.emit);
+  return [.../* @__PURE__ */ new Set([...claimed, ...m.emits ?? []])];
+}
+function holds(claim, installed, ctx) {
+  if (!claim)
+    return true;
+  if (claim.codecs && (ctx?.codec === void 0 || !claim.codecs.includes(ctx.codec)))
+    return false;
+  if (claim.reads?.some((name) => !installed.has(name)))
+    return false;
+  if (claim.homeBaseAttached !== void 0 && ctx?.homeBaseAttached !== void 0) {
+    return ctx.homeBaseAttached === claim.homeBaseAttached;
+  }
+  return true;
 }
 
 // dist/model/capabilities/video.js
@@ -3755,6 +3776,9 @@ var AiDetectType = {
   vehicle: 4,
   pet: 8
 };
+var CAMERA_AI_CLAIM = { codecs: ["camera"] };
+var VEHICLE_CLAIM = { ...CAMERA_AI_CLAIM, reads: ["aiDetectType"] };
+var DOG_CLAIM = { ...CAMERA_AI_CLAIM, homeBaseAttached: true };
 var SENSITIVITY_SCALES = [
   /** Standalone PIR sensor: five steps counting DOWN. */
   {
@@ -4146,21 +4170,24 @@ var MOTION = {
   events: [
     { source: "push", match: DoorbellPushEvent.MOTION_DETECTION, emit: "motion" },
     { source: "push", match: CusPushEvent.MOTION_SENSOR_PIR, emit: "motion" },
-    { source: "push", match: IndoorPushEvent.CRYING_DETECTION, emit: "cryingDetected" },
-    { source: "push", match: IndoorPushEvent.SOUND_DETECTION, emit: "soundDetected" },
-    { source: "push", match: DoorbellPushEvent.VEHICLE_DETECTION, emit: "vehicleDetected" },
-    { source: "push", match: HB3PairedDevicePushEvent.DOG_DETECTION, emit: "dogDetected" },
+    { source: "push", match: IndoorPushEvent.CRYING_DETECTION, emit: "cryingDetected", claim: CAMERA_AI_CLAIM },
+    { source: "push", match: IndoorPushEvent.SOUND_DETECTION, emit: "soundDetected", claim: CAMERA_AI_CLAIM },
+    { source: "push", match: IndoorPushEvent.PET_DETECTION, emit: "petDetection", claim: CAMERA_AI_CLAIM },
+    { source: "push", match: DoorbellPushEvent.VEHICLE_DETECTION, emit: "vehicleDetected", claim: VEHICLE_CLAIM },
+    { source: "push", match: HB3PairedDevicePushEvent.DOG_DETECTION, emit: "dogDetected", claim: DOG_CLAIM },
     {
       source: "push",
       match: HB3PairedDevicePushEvent.DOG_LICK_DETECTION,
       emit: "dogDetected",
-      payload: { kind: "lick" }
+      payload: { kind: "lick" },
+      claim: DOG_CLAIM
     },
     {
       source: "push",
       match: HB3PairedDevicePushEvent.DOG_POOP_DETECTION,
       emit: "dogDetected",
-      payload: { kind: "poop" }
+      payload: { kind: "poop" },
+      claim: DOG_CLAIM
     }
   ]
 };
@@ -6830,10 +6857,16 @@ var DOORBELL = {
   properties: propertiesOf(DOORBELL_MEMBERS),
   /** Doorbells self-report no single unambiguous param; the model name is the reliable signal. */
   detection: { modelHints: [/doorbell/i] },
-  /** Inbound FCM doorbell events (`DoorbellPushEvent`): ring press, pet, package delivered/taken. */
+  /**
+   * Inbound FCM doorbell events (`DoorbellPushEvent`): ring press and the package trio.
+   *
+   * Pet (3106) is NOT here. The id is declared identically in the doorbell, indoor and HB3-paired
+   * vocabularies, so it belongs to the camera-wide `motion` module that every camera binds; claiming
+   * it here as well would make it a contested id that a doorbell — which has both capabilities —
+   * matches twice, emitting one push as two events.
+   */
   events: [
     { source: "push", match: DoorbellPushEvent.PRESS_DOORBELL, emit: "doorbellPress" },
-    { source: "push", match: DoorbellPushEvent.PET_DETECTION, emit: "petDetection" },
     { source: "push", match: DoorbellPushEvent.PACKAGE_DELIVERED, emit: "packageDelivered" },
     { source: "push", match: DoorbellPushEvent.PACKAGE_TAKEN, emit: "packageTaken" },
     { source: "push", match: DoorbellPushEvent.PACKAGE_STRANDED, emit: "packageStranded" }
@@ -8326,6 +8359,25 @@ var CARPET_STRATEGIES = ["autoRaise", "avoid", "ignore"];
 var CARPET_STRATEGY = { 0: "autoRaise", 1: "avoid", 2: "ignore" };
 var CLEAN_EXTENTS = ["normal", "narrow", "quick"];
 var CLEAN_EXTENT = { 0: "normal", 1: "narrow", 2: "quick" };
+function cleanParamWireValue(names, name) {
+  const found = Object.entries(names).find(([, candidate]) => candidate === name);
+  if (found === void 0)
+    throw new Error(`clean param: ${name} is not a value this setting takes`);
+  return Number(found[0]);
+}
+function writeCleanSetting(p, wrapper, inner, value) {
+  p.sub(wrapper, (w) => {
+    if (value !== 0)
+      w.int(inner, value);
+  });
+}
+function encodeCleanParam(cleanType, cleanExtent, mopLevel) {
+  return rawDp((w) => w.sub(CLEAN_PARAM_FIELD.CONFIGURED, (p) => {
+    writeCleanSetting(p, CLEAN_PARAM_FIELD.CLEAN_TYPE, CLEAN_PARAM_FIELD.VALUE, cleanParamWireValue(CLEAN_TYPE, cleanType));
+    writeCleanSetting(p, CLEAN_PARAM_FIELD.CLEAN_EXTENT, CLEAN_PARAM_FIELD.VALUE, cleanParamWireValue(CLEAN_EXTENT, cleanExtent));
+    writeCleanSetting(p, CLEAN_PARAM_FIELD.MOP_MODE, CLEAN_PARAM_FIELD.MOP_LEVEL, cleanParamWireValue(MOP_LEVEL, mopLevel));
+  }));
+}
 function decodeCleanParamValue(raw, codec, field, inner) {
   if (typeof raw !== "string" || !codec)
     return void 0;
@@ -10005,6 +10057,49 @@ var VACUUM_CLEAN_MEMBERS = {
    * WATCHED: run on a T2351, it started the named scene.
    */
   startScene: method(({ sink }) => (sceneId) => sink.dispatch(aiotDp(VACUUM_DP.MODE_CTRL, encodeSceneClean(sceneId))), "Run a saved cleaning scene by its id (ModeCtrlRequest method 24 over DP 152).", isAiotVacuum),
+  /**
+   * State the cleaning settings a run uses — `CleanParamRequest.clean_param` over DP 154.
+   *
+   * The write counterpart of {@link VACUUM_CLEAN_MEMBERS.cleanType},
+   * {@link VACUUM_CLEAN_MEMBERS.cleanExtent} and {@link VACUUM_CLEAN_MEMBERS.mopLevel}: one message
+   * carries all three, so they are set together rather than through three setters that would each send
+   * the same message with the other two silent.
+   *
+   * **The evidence, and its limit.** The frame is field 1 of `CleanParamRequest`, which carries the
+   * very `CleanParam` this module decodes out of field 1 of the reports a live T2351 sends — the
+   * field numbers, the single-field wrappers and the `mop_mode.level` scale are all read off that
+   * capture, and `encodeCleanParam` writes what `decodeCleanParamValue` reads. What is NOT captured is
+   * the write direction itself. It ships as a method rather than an unverified write because the
+   * hazard that rule answers does not arise here: DP 154 is the robot's own settings report, so a frame
+   * it does not accept leaves those three reads unchanged, where a wrong fire-and-forget command would
+   * look exactly like success.
+   *
+   * Suction is not here. It has its own data point and its own capability — a `fan` field exists in
+   * this message and is deliberately not written, for the same reason it is not read.
+   */
+  setCleanParam: {
+    ...method(({ sink }) => (cleanType, cleanExtent, mopLevel) => sink.dispatch(aiotDp(VACUUM_DP.CLEAN_PARAM, encodeCleanParam(cleanType, cleanExtent, mopLevel))), "Set the cleaning type, extent and mop water level together (CleanParamRequest.clean_param over DP 154).", isAiotVacuum),
+    args: [
+      {
+        name: "cleanType",
+        kind: "enum",
+        values: VACUUM_CLEAN_TYPES,
+        description: "What the robot does with a surface."
+      },
+      {
+        name: "cleanExtent",
+        kind: "enum",
+        values: CLEAN_EXTENTS,
+        description: "How far past the mapped edge a job reaches. Wire order, not app order."
+      },
+      {
+        name: "mopLevel",
+        kind: "enum",
+        values: MOP_LEVELS,
+        description: "How much water the mop lays down. Only meaningful for a clean type that mops."
+      }
+    ]
+  },
   /**
    * Clean the named rooms of a named map (ModeCtrlRequest method 1 over DP 152).
    *
@@ -13043,7 +13138,8 @@ var Device = class _Device {
       details: describeCapabilities(this.actionMap, {
         codec: this.codec,
         model: this.model,
-        capabilities: new Set(this.capabilities)
+        capabilities: new Set(this.capabilities),
+        homeBaseAttached: this.stationSn !== this.sn
       })
     };
   }
@@ -27059,45 +27155,79 @@ var SolixClient = class _SolixClient {
 import { EventEmitter as EventEmitter10 } from "node:events";
 var SOLIX_METER_FIELD_NAMES = {
   168: "meterPowerL1",
+  // Anker Modbus: primary_phase_1_active_power
   169: "meterPowerL2",
+  // Anker Modbus: primary_phase_2_active_power
   170: "meterPowerL3",
+  // Anker Modbus: primary_phase_3_active_power
   171: "meterPowerTotal",
+  // Anker Modbus: primary_total_active_power
   172: "meterVoltageL1",
+  // Anker Modbus: primary_phase_1_voltage
   173: "meterVoltageL2",
+  // Anker Modbus: primary_phase_2_voltage
   174: "meterVoltageL3",
+  // Anker Modbus: primary_phase_3_voltage
   175: "meterCurrentL1",
+  // Anker Modbus: primary_phase_1_current
   176: "meterCurrentL2",
+  // Anker Modbus: primary_phase_2_current
   177: "meterCurrentL3",
+  // Anker Modbus: primary_phase_3_current
   179: "meterImportEnergy",
+  // Anker Modbus: primary_total_forward_active_energy
   180: "meterExportEnergy"
+  // Anker Modbus: primary_total_reverse_active_energy
 };
 var SOLIX_METER_PRODUCT_PREFIXES = ["AE1X0"];
 var SOLIX_SOLARBANK_PRODUCT_PREFIX = "AE10";
 var SOLIX_SOLARBANK_FIELD_NAMES = {
   171: "photovoltaicPower",
-  // total PV input across the strings
+  // total PV input across the strings — Anker Modbus: pv_power
   172: "batteryPower",
+  // signed net pack power — Anker Modbus: battery_charging_power − battery_discharging_power
   188: "chargePower",
+  // Anker Modbus: battery_charging_power
   173: "dischargePower",
+  // Anker Modbus: battery_discharging_power
   174: "acPlugPower",
+  // AC plug, signed — Anker Modbus: ac_grid_output_power
   175: "socketPower",
-  // the unit's own on-board AC socket (an appliance plugged into the Solarbank)
+  // the unit's own on-board AC socket (an appliance plugged into the Solarbank) — no Anker register
   196: "gridInputPower",
+  // Anker Modbus: grid_import_power
   197: "homeLoadPower",
+  // Anker Modbus: load_power
   198: "pv1Power",
-  // the four PV-string inputs (0 when a string is unused / dark)
+  // the four PV-string inputs (0 when a string is unused / dark); Anker exposes only a pv_power total
   199: "pv2Power",
   200: "pv3Power",
   201: "pv4Power"
 };
 var SOLIX_STATE_FIELD_NAMES = {
   169: "mode",
-  // current operating (EMS) mode (1 custom, 2 self-consumption, 4 rapid charge, 7 smart, 8 dynamic tariff)
+  // current operating (EMS) mode, AE103 numbering: 1 custom, 2 self-consumption, 4 rapid charge, 7 smart, 8 dynamic tariff (NOT the Modbus SOLIX_MODBUS_EMS_MODES numbering)
   170: "maxLoad"
   // configured max home load (W) — matches get_site_device_param max_load
   // NOTE `0xab` is grid-in/out-related power but its exact meaning is not yet pinned, so it stays raw
   // `state_ab` (a diagnostic a consumer can watch) rather than being asserted under a guessed name.
 };
+var SOLIX_MODBUS_EMS_MODES = {
+  0: "selfConsumption",
+  // Self-Consumption Mode (Anker: self_consumption, 0x8006 BIT0)
+  1: "timeOfUse",
+  // Time Of Use Mode (Anker: tou_mode, BIT1)
+  3: "thirdPartyControl",
+  // Third-Party Controlled (Anker: third_party_control, BIT5)
+  4: "custom",
+  // Custom Mode (Anker: custom_mode, BIT2)
+  5: "socketOverlay",
+  // Socket Overlay Mode (Anker: socket_overlay_mode, BIT4)
+  6: "smart",
+  // Smart Mode (Anker: smart_mode, BIT3)
+  7: "dynamicTariff"
+  // Dynamic Tariff Mode (Anker: dynamic_pricing, BIT6)
+};
 function solixStateReadings(frame) {
   const out = {};
   for (const [tag2, value] of frame.fields) {
@@ -27660,6 +27790,7 @@ export {
   SMOKE_MEMBERS,
   SOLIX_ENERGY_METER_MEMBERS,
   SOLIX_LOCAL_KEY_HEX,
+  SOLIX_MODBUS_EMS_MODES,
   STATE_EVENT_FIELDS,
   STATION_CHANNEL3 as STATION_CHANNEL,
   STATION_CHUNK_BYTES,