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

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
       })
     };
   }