@mega-yfue/eufy-sdk 0.4.0-beta.31 → 0.4.0-beta.33

package/dist/index.js

@@ -3273,7 +3273,7 @@ function propertiesOf(members, ctx) {
         unit: m.unit,
         enumValues: enumValues2,
         provenance: m.provenance,
-        invert: promoted?.invert ?? m.invert,
+        invert: promoted?.invert ?? (ctx ? m.invertFor?.(ctx) : void 0) ?? m.invert,
         decode: m.coerce,
         // A member with a getter-side `decode` reads a field out of a structured payload, so the
         // stored value is that payload — see `PropertySpec.raw`.
@@ -5205,8 +5205,10 @@ var AUDIO = {
 
 // dist/model/capabilities/camera.js
 var CAMERA_CMD = {
-  /** Camera on/off. switch is inverted: camera ON ⇒ 0, OFF ⇒ 1. */
+  /** Camera on/off. Read and write polarity depend on the family and topology. */
   CAMERA_ENABLE: 1035,
+  /** Wrapped T8410 power switch on HomeBase 3. */
+  PRIVACY_MODE: 6250,
   /**
    * Camera status LED on/off — the "power/recording" indicator. The
    * app JS has a sibling param `1056` (`APP_CMD_LIVEVIEW_LED_SWITCH`) for the SAME UI "Status Light"
@@ -5426,7 +5428,27 @@ var ENABLE_BIT_FLOODLIGHT_TYPES = /* @__PURE__ */ new Set([
 function powerValue(on, ctx) {
   return isEnableBitPolarity(ctx) ? on ? 1 : 0 : on ? 0 : 1;
 }
+function isT8410HomeBase3(ctx) {
+  return ctx.model === "T8410" && ctx.stationSerial?.startsWith("T8030") === true;
+}
+function usesHomeBasePowerPayload(ctx) {
+  if (!isT8410HomeBase3(ctx) || !ctx.firmwareVersion || !/^\d+(?:\.\d+){2,3}$/.test(ctx.firmwareVersion))
+    return false;
+  const version = ctx.firmwareVersion.split(".").map(Number);
+  const minimum = [2, 3, 1, 0];
+  for (let i = 0; i < minimum.length; i++) {
+    const difference = (version[i] ?? 0) - minimum[i];
+    if (difference !== 0)
+      return difference > 0;
+  }
+  return true;
+}
+function hasUnreflectedHomeBasePower(ctx) {
+  return usesHomeBasePowerPayload(ctx) && !ctx.paramIds.has(2001);
+}
 function powerCommand(on, ctx) {
+  if (usesHomeBasePowerPayload(ctx))
+    return setPayload(CAMERA_CMD.PRIVACY_MODE, { switch: on ? 0 : 1 }, ctx, 0);
   return setScalar(CAMERA_CMD.CAMERA_ENABLE, powerValue(on, ctx), ctx, "auto");
 }
 function privacyCommand(enabled, channel) {
@@ -5444,28 +5466,34 @@ function enablementReflection(on, ctx) {
   const alias = CAMERA_MEMBERS.enabled.readAliases[0].paramType;
   if (ctx.paramIds.has(alias))
     return { param: alias, expected: on, observed: on };
+  if (hasUnreflectedHomeBasePower(ctx))
+    return void 0;
   if (ctx.paramIds.has(CAMERA_CMD.CAMERA_ENABLE)) {
-    return { param: CAMERA_CMD.CAMERA_ENABLE, expected: powerValue(on, ctx), observed: on };
+    return {
+      param: CAMERA_CMD.CAMERA_ENABLE,
+      expected: powerValue(on, ctx),
+      observed: on
+    };
   }
   return void 0;
 }
 function refuseWhenDisabled(ctx, read) {
-  if (read("enabled")?.value === false)
+  if (!hasUnreflectedHomeBasePower(ctx) && read("enabled")?.value === false)
     throw new CameraDisabledError(ctx.name ?? ctx.serial);
 }
 var CAMERA_MEMBERS = {
   /**
-   * The READ is the *disable*-bit convention (1035 "0" ⇒ ON, 2001 direct); the WRITE polarity is
+   * The default READ is the *disable*-bit convention (1035 "0" ⇒ ON, 2001 direct); the WRITE polarity is
    * family-dependent — see `powerValue` / `isEnableBitPolarity`. Battery/solo cams report the state under
    * 1035, standalone indoor/outdoor cams under 2001 OPEN_DEVICE with direct polarity, so 2001 is a
    * read-alias. Both verified live, and the write polarity is confirmed against the app's own frames.
    *
-   * The read and the setter observe the SAME wire on every family — see `powerCommand` — which is what
-   * makes this value track what it is told, and what lets `enablementReflection` confirm a write.
+   * T8410 on HomeBase 3 reports 1035 as an enable bit ("1" ⇒ ON). That reported state does not reliably
+   * reflect the privacy command. `readReflectsWrite` states this distinction.
    *
    * The privacy param (6250) is reported by the outdoor-PT family and by no other camera measured, and both
    * of its polarities are observed. It is deliberately NOT aliased here: it moved in the same step as 1035, so
-   * the reading cannot say whether power and privacy are one state or two, and the app drives 1035 — so
+   * the reading cannot say whether power and privacy are one state or two — so
    * aliasing a second param could only fold two possible states into one getter for no gain.
    */
   enabled: {
@@ -5474,8 +5502,10 @@ var CAMERA_MEMBERS = {
     kind: "boolean",
     provenance: "verified",
     invert: true,
+    invertFor: (ctx) => isT8410HomeBase3(ctx) ? false : void 0,
     readAliases: [{ paramType: 2001, invert: false }],
-    description: "Camera enabled. Family-dependent wire param: 1035 CMD_DEVS_SWITCH (disable bit, battery/solo cams) or 2001 OPEN_DEVICE (standalone indoor/outdoor). Reliable on/off status source (a live-stream probe is not).",
+    readReflectsWrite: (ctx) => !hasUnreflectedHomeBasePower(ctx),
+    description: "Camera enabled. Family-dependent wire param: 1035 CMD_DEVS_SWITCH (enable bit on T8410/HomeBase 3, disable bit on battery/solo cams) or 2001 OPEN_DEVICE (standalone indoor/outdoor). Reported on/off state; unreflectedMembers identifies commands whose effect this report does not reliably reflect.",
     observation: {
       event: "cameraEnabledChanged",
       reflects: (value, ctx) => enablementReflection(asBool(value), ctx),
@@ -5702,7 +5732,7 @@ var CAMERA_MEMBERS = {
    * value, and it exists only on a device bound to a provider. Each is declared once, with its
    * signature taken FROM {@link MediaProvider} — so a change there is a compile error here, not a drift.
    *
-   * Every pull is refused where {@link CAMERA_MEMBERS.enabled} reads false, with {@link CameraDisabledError} —
+   * Every pull is refused where a reliable {@link CAMERA_MEMBERS.enabled} reads false, with {@link CameraDisabledError} —
    * `live`, `snapshotLive`, `record`, `openReadable` and `recordFragments` alike, since each opens media on a
    * camera that serves none. That reading is the on/off source; a live probe is not one, since a disabled
    * camera answers a start with audio and never a video frame.
@@ -11160,7 +11190,8 @@ function resolveProperties(rec, codec, capabilities) {
     model: rec.model,
     category: rec.category,
     capabilities: new Set(capabilities),
-    paramIds
+    paramIds,
+    stationSerial: rec.parentSn
   });
 }
 
@@ -13350,7 +13381,8 @@ var Device = class _Device {
         codec: this.codec,
         model: this.model,
         capabilities: new Set(this.capabilities),
-        homeBaseAttached: this.stationSn !== this.sn
+        homeBaseAttached: this.stationSn !== this.sn,
+        stationSerial: this.stationSn
       })
     };
   }
@@ -16214,8 +16246,17 @@ var P2PSession = class _P2PSession extends EventEmitter2 {
     this.send(this.connectAddress, RequestMessageType.DATA, data);
     return true;
   }
-  /** Stop the realtime media stream (`CMD_STOP_REALTIME_MEDIA`, 1004) on a camera `channel`. */
-  stopLiveMedia(channel = STATION_CHANNEL3, accountId = "") {
+  /**
+   * Stop the realtime media stream (`CMD_STOP_REALTIME_MEDIA`, 1004) on a camera `channel`, in the shape
+   * its runtime topology takes, as {@link startLiveMedia} selects its start:
+   *  - `homeBaseAttached`: `CMD_SET_PAYLOAD` (1350) wrapping `{cmd:1004, mChannel:channel}` at level-2.
+   *  - own-session at level-2: the direct 1004 frame whose entire plaintext is the camera channel as a
+   *    `uint32`, the same 4-byte body as the attached talkback frames. The app sends this frame on closing
+   *    an own-session camera's live view; the camera stops streaming on it within a second, and keeps
+   *    streaming through the 1350-wrapped form.
+   *  - without a level-2 key: the bare 1004 command.
+   */
+  stopLiveMedia(channel = STATION_CHANNEL3, accountId = "", homeBaseAttached = false) {
     this.liveStartedChannels.delete(channel);
     for (const [sequence, pending] of this.unackedLiveStarts) {
       if (pending.channel === channel)
@@ -16225,7 +16266,11 @@ var P2PSession = class _P2PSession extends EventEmitter2 {
       clearInterval(this.liveStartRetransmitTimer);
       this.liveStartRetransmitTimer = void 0;
     }
-    if (this.level2Key) {
+    if (this.level2Key && !homeBaseAttached) {
+      const body = Buffer.allocUnsafe(4);
+      body.writeUInt32LE(channel >>> 0, 0);
+      this.sendRawLevel2Bytes(body, channel, CMD_STOP_REALTIME_MEDIA, 8);
+    } else if (this.level2Key) {
       this.sendMediaPayloadLevel2(CMD_STOP_REALTIME_MEDIA, channel, accountId, {});
     } else {
       this.sendCommand(CMD_STOP_REALTIME_MEDIA, channel);
@@ -17991,7 +18036,7 @@ var LiveStream = class extends EventEmitter3 {
       clearTimeout(this.stallTimer);
     this.stallTimer = void 0;
     try {
-      this.session.stopLiveMedia(this.opts.channel, this.opts.accountId);
+      this.session.stopLiveMedia(this.opts.channel, this.opts.accountId, this.opts.homeBaseAttached);
     } catch (e) {
       this.logger.debug(`[live] stopLiveMedia ignored: ${e instanceof Error ? e.message : e}`);
     }
@@ -27297,6 +27342,7 @@ var EufyMega = class extends EventEmitter9 {
       model: rec.model,
       category: dev.category,
       serial: sn,
+      stationSerial: rec.parentSn,
       // Identity metadata for `info`, for a host's device-registry surface. `name` = the app-shown
       // device_name (registry's `name`), not the resolved codec/inferred name. firmware/hardware come
       // straight off the device record: `main_sw_version` / `main_hw_version` — the same fields the v6