@mega-yfue/eufy-sdk 0.6.0-beta.24 → 0.6.0-beta.26

package/dist/core/contracts.d.ts

@@ -344,6 +344,8 @@ export type Command = {
     cmd: number;
     value: number;
     channel: number;
+    /** `"auto"`: the seal follows the session, level-2 with a key and level-1 without. Absent, level-2 only. */
+    form?: Extract<ScalarForm, "auto">;
 }
 /** P2P int-plus-string frame; the transport injects the authenticated account id string. */
  | {

package/dist/index.js

@@ -3304,8 +3304,8 @@ function setJsonRaw(cmd, data, ctx, channel) {
 function setPayload(cmd, payload, ctx, mValue3, channel, form) {
   return { kind: "set-payload", cmd, payload, channel: channel ?? ctx.channel, mValue3, form };
 }
-function setStationScalar(cmd, value, channel) {
-  return { kind: "p2p-station-scalar", cmd, value, channel };
+function setStationScalar(cmd, value, channel, form) {
+  return { kind: "p2p-station-scalar", cmd, value, channel, ...form ? { form } : {} };
 }
 function describeDevice(ctx) {
   return `deviceType=${ctx.deviceType ?? "?"} model=${ctx.model ?? "?"} serial=${ctx.serial ?? "?"} channel=${ctx.channel} codec=${ctx.codec}`;
@@ -3474,12 +3474,13 @@ function describe(description, fn, m) {
 function reports(requires, ctx) {
   return !requires || requires.some((p) => ctx.paramIds.has(p));
 }
-function narrow(type, read, prop) {
+function narrow(type, read, prop, values) {
   if (type === "bool")
     return readBool(read, prop);
   if (type === "string")
     return readStr(read, prop);
-  return readNum(read, prop);
+  const n = readNum(read, prop);
+  return values && n !== void 0 && !(n in values) ? void 0 : n;
 }
 function reads(m, ctx) {
   return m.realtime === true || sent(m, ctx);
@@ -3532,7 +3533,9 @@ function bindMembers(members, deps) {
     if (reported && !m.writeOnly && !m.unexposed) {
       const decode = m.decode;
       const raw = () => read(prop)?.value ?? (borrowed === void 0 ? void 0 : read(borrowed)?.value);
-      const get = decode ? () => decode(raw(), rawDp2, ctx) : () => narrow(m.type, read, prop);
+      const { values, dynamic } = resolvedEnum(m, ctx);
+      const domain = (dynamic ? "enum" : m.kind) === "enum" ? values : void 0;
+      const get = decode ? () => decode(raw(), rawDp2, ctx) : () => narrow(m.type, read, prop, domain);
       Object.defineProperty(out, name, { get, enumerable: true, configurable: true });
     }
     if (!m.write || m.unverified || !installs(m, ctx))
@@ -4802,7 +4805,7 @@ var BATTERY_MEMBERS = cellGated({
   /**
    * 1293 is the READABLE indicator (6445 is write-only/cloud-hidden). Verified live on a T8124R via an
    * app-toggle before/after diff: 0 = Battery, 1 = External Solar Panel. Values beyond 0/1 (some models
-   * report 5) are shown raw — `enumValues` only labels the two that are confirmed.
+   * report 5) read as `undefined` — `enumValues` holds only the two that are confirmed.
    *
    * The write is a `1350` SET_PAYLOAD, inner cmd 1293, `{charge_mode:N}`, `mValue3` 0 (the app uses 0,
    * not the cmd id), and the setter accepts a NAME as well as the index the getter answers.
@@ -4817,7 +4820,7 @@ var BATTERY_MEMBERS = cellGated({
     requires: [BATTERY_PARAM.POWER_CHARGE],
     args: [{ name: "source", kind: "enum", description: "The raw value, or the name `battery`/`external`." }],
     ...accepts(),
-    description: "Configured power source (1293): 0 = Battery, 1 = External Solar Panel. Verified live on T8124R. The richer raw APP_CMD_SET_POWER_SOURCE blob is surfaced separately as `powerSourceInfo` (6445). Format varies by model (plain int or JSON {power_source:N}); values beyond 0/1 shown raw.",
+    description: "Configured power source (1293): 0 = Battery, 1 = External Solar Panel. Verified live on T8124R. The richer raw APP_CMD_SET_POWER_SOURCE blob is surfaced separately as `powerSourceInfo` (6445). Format varies by model (plain int or JSON {power_source:N}); a value beyond 0/1 reads undefined.",
     write: (v, ctx) => setPayload(BATTERY_PARAM.POWER_CHARGE, { charge_mode: v === "external" ? 1 : v === "battery" ? 0 : asBool(v) ? 1 : 0 }, ctx, 0, void 0, "auto")
   },
   /**
@@ -6199,6 +6202,10 @@ var CAMERA_MEMBERS = {
    * sensor omits it, and the wire accepts the value regardless — the device's own reported set is the
    * only statement of which of the three it has. `coerceEnumValue` rejects a value outside
    * {@link NightVision} rather than coercing it. The payload key on the wire is `night_sion`.
+   *
+   * 1277 carries more than these three on some models: the V6 app's per-model mappings put modes on
+   * 3, 5, 6 and 8 as well, and which model takes which mapping is not in the app bundle. A reported value
+   * outside the published options reads as `undefined` rather than as an unnamed number.
    */
   nightVision: {
     param: CAMERA_CMD.NIGHT_VISION_TYPE,
@@ -7970,7 +7977,8 @@ var ARMING_CMD = {
    * was captured on holds a level-2 key and seals it level-2, while an own-session camera that never
    * negotiates one carries the same envelope level-1. See `armingCommand`.
    *
-   * A T8410C takes the mode as a direct frame instead of this envelope; see {@link DIRECT_ARMING_MODELS}.
+   * A T8410C and a T8410 take the mode as a direct frame instead of this envelope; see
+   * {@link DIRECT_ARMING_MODELS} and {@link BROADCAST_ARMING_MODELS}.
    */
   SET_ARMING: 1224,
   /**
@@ -8010,7 +8018,7 @@ var ARMING_CMD = {
 var DEVICE_NOTIFY_FLAG = 8;
 var STANDALONE_ACTION_MODELS = /* @__PURE__ */ new Set(["T8170", "T8171"]);
 var DIRECT_ARMING_MODELS = /* @__PURE__ */ new Set(["T8410C"]);
-var DIRECT_ARMING_MODES = /* @__PURE__ */ new Set(["away", "home", "disarmed"]);
+var BROADCAST_ARMING_MODELS = /* @__PURE__ */ new Set(["T8410"]);
 var STANDALONE_READ_MODELS = /* @__PURE__ */ new Set([...STANDALONE_ACTION_MODELS, "T8400", "T8442", "T8410"]);
 function ownAction(read, mode) {
   const value = Number(read(`${mode}Action`)?.value);
@@ -8043,10 +8051,11 @@ function armingCommand(mode, ctx) {
   if (!ctx.accountName) {
     throw new Error(`arming: missing account identity (user_name) [${describeDevice(ctx)}]`);
   }
-  if (DIRECT_ARMING_MODELS.has(ctx.model ?? "")) {
-    if (!DIRECT_ARMING_MODES.has(mode)) {
-      throw new Error(`arming: mode ${mode} is unconfirmed on the direct 1224 frame [${describeDevice(ctx)}]`);
-    }
+  const model = ctx.model ?? "";
+  if (BROADCAST_ARMING_MODELS.has(model)) {
+    return setStationScalar(ARMING_CMD.SET_ARMING, ARMING_MODE_WIRE[mode], STATION_CHANNEL2, "auto");
+  }
+  if (DIRECT_ARMING_MODELS.has(model)) {
     return setStationScalar(ARMING_CMD.SET_ARMING, ARMING_MODE_WIRE[mode], ctx.channel);
   }
   return setPayload(ARMING_CMD.SET_ARMING, { mode_type: ARMING_MODE_WIRE[mode], user_name: ctx.accountName }, ctx, 0, void 0, "auto");
@@ -8104,7 +8113,7 @@ var ARMING_MEMBERS = {
     kind: "enum",
     enumValues: ARMING_MODE_LABELS,
     provenance: "verified",
-    description: "Guard mode (verified: param 1224 = GUARD_MODE, read/write mechanism confirmed). Reads and SETS all 9 modes the app defines \u2014 away/home/schedule/custom1/custom2/custom3/off/geo/disarmed. Three are byte-captured writes and six are live-confirmed (each sent and observed to report its own MODE_SWITCH); see ARMING_MODE_WIRE in arming.ts for the per-value evidence. On a T8410C only away, home and disarmed are writable.",
+    description: "Guard mode (verified: param 1224 = GUARD_MODE, read/write mechanism confirmed). Reads and SETS all 9 modes the app defines \u2014 away/home/schedule/custom1/custom2/custom3/off/geo/disarmed. Three are byte-captured writes and six are live-confirmed (each sent and observed to report its own MODE_SWITCH); see ARMING_MODE_WIRE in arming.ts for the per-value evidence.",
     observation: {
       event: "armingModeChanged",
       reflects: (value) => ({ param: ARMING_CMD.SET_ARMING, expected: ARMING_MODE_WIRE[armingModeOf(value)] }),
@@ -14185,7 +14194,7 @@ var Device = class _Device {
       const spec = this.specByName.get(name);
       if (!spec)
         continue;
-      const value = spec.raw ? void 0 : narrow(spec.type, (n) => this.state.get(n), name);
+      const value = spec.raw ? void 0 : narrow(spec.type, (n) => this.state.get(n), name, spec.kind === "enum" ? spec.enumValues : void 0);
       out.push(value === void 0 ? { property: name } : { property: name, value });
     }
     return out;
@@ -22795,7 +22804,7 @@ var P2PCommandRouter = class _P2PCommandRouter {
         await this.sendSetPayloadEnvelope(sn, cmd.cmd, cmd.payload, cmd.channel, cmd.mValue3, void 0, cmd.form, cmd.level2Sender);
         return;
       case "p2p-station-scalar":
-        await this.sendStationScalar(sn, cmd.cmd, cmd.value, cmd.channel);
+        await this.sendStationScalar(sn, cmd.cmd, cmd.value, cmd.channel, cmd.form);
         return;
       case "p2p-int-string":
         await this.sendIntString(sn, cmd.cmd, cmd.value, cmd.valueSub, cmd.channel);
@@ -22837,10 +22846,7 @@ var P2PCommandRouter = class _P2PCommandRouter {
    * control here is.
    */
   async rebootStation(sn) {
-    await this.sendBySessionLevel(sn, {
-      l2: (resolved) => this.replayLevel2Send(sn, `reboot ${sn}`, ({ session, accountId }) => session.sendRawLevel2Bytes(buildDirectBinaryBody(0, accountId), 255, P2P_ENVELOPE.RESTART_HUB, 8), resolved),
-      l1: (resolved) => this.replayLevel2Send(sn, `reboot ${sn}`, ({ session, accountId }) => session.sendRawLevel1Bytes(buildDirectBinaryBody(0, accountId), 255, P2P_ENVELOPE.RESTART_HUB), resolved)
-    });
+    return this.sendStationScalar(sn, P2P_ENVELOPE.RESTART_HUB, 0, 255, "auto");
   }
   /**
    * A {@link MediaProvider} bound to one serial — resolves the session then calls `p2p/media`.
@@ -23736,9 +23742,19 @@ var P2PCommandRouter = class _P2PCommandRouter {
    * **Station-scoped scalar** (`p2p-station-scalar` intent): the 132-byte channel-less body
    * ({@link buildDirectBinaryBody} with no `channel`) on an EXPLICIT channel, signCode 8. The
    * HomeBase's own controls ride the station broadcast channel 255 (alarm/speaker volume 1235).
+   *
+   * `form` `"auto"` seals it at the session's level, as {@link sendBySessionLevel} defines it: level-2 on a
+   * keyed session, the same body sealed level-1 on a keyless one. Absent, the send waits for the level-2 key.
    */
-  async sendStationScalar(sn, outerCmd, value, channel) {
-    await this.replayLevel2Send(sn, `station scalar cmd ${outerCmd}`, ({ session, accountId }) => session.sendRawLevel2Bytes(buildDirectBinaryBody(value, accountId), channel, outerCmd, 8));
+  async sendStationScalar(sn, outerCmd, value, channel, form) {
+    const describe2 = `station scalar cmd ${outerCmd}`;
+    const l2 = (resolved) => this.replayLevel2Send(sn, describe2, ({ session, accountId }) => session.sendRawLevel2Bytes(buildDirectBinaryBody(value, accountId), channel, outerCmd, 8), resolved);
+    if (form !== "auto")
+      return l2();
+    await this.sendBySessionLevel(sn, {
+      l2,
+      l1: (resolved) => this.replayLevel2Send(sn, describe2, ({ session, accountId }) => session.sendRawLevel1Bytes(buildDirectBinaryBody(value, accountId), channel, outerCmd), resolved)
+    });
   }
   /** Send a level-1 int-plus-string frame with authenticated account identity injected by the transport. */
   async sendIntString(sn, commandType, value, valueSub, channel) {