@mega-yfue/eufy-sdk 0.6.0-beta.42 → 0.6.0-beta.44

package/dist/index.js

@@ -3462,7 +3462,7 @@ function propertiesOf(members, ctx) {
         // stored value is that payload — see `PropertySpec.raw`.
         raw: m.decode ? true : void 0,
         readAliases: aliases?.slice(promoted ? 1 : 0).map(({ paramType, invert }) => ({ paramType, invert })),
-        writable: m.write !== void 0 || m.writtenElsewhere === true,
+        writable: m.write !== void 0 && !(ctx && m.unverifiedFor?.(ctx)) || m.writtenElsewhere === true,
         reported: ctx?.paramIds ? wasReported(m, borrowedBy(m, members), { ...ctx, paramIds: ctx.paramIds }) : void 0,
         description: m.description
       }
@@ -3635,7 +3635,7 @@ function bindMembers(members, deps) {
       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) || !writeRoutable(m, ctx))
+    if (!m.write || m.unverified || m.unverifiedFor?.(ctx) || !installs(m, ctx) || !writeRoutable(m, ctx))
       continue;
     if (m.writeOnly)
       unobservable.push(name);
@@ -6865,25 +6865,12 @@ var LIGHT_SWITCH_INT_STRING_TYPES = /* @__PURE__ */ new Set([
   DeviceType.CAMERA3C,
   DeviceType.PROFESSIONAL_247
 ]);
-function switchCommand(on, ctx) {
-  switch (lightSwitchWire(ctx)) {
-    case "json":
-      return setJson(LIGHT_CMD.FLOODLIGHT_SWITCH, { time: 0, type: 2, value: on ? 1 : 0 }, ctx);
-    case "int-string":
-      return setScalar(LIGHT_CMD.FLOODLIGHT_SWITCH, on ? 1 : 0, ctx, "int-string");
-    default:
-      return void 0;
-  }
+function switchCommand(on, wire, ctx) {
+  return wire === "json" ? setJson(LIGHT_CMD.FLOODLIGHT_SWITCH, { time: 0, type: 2, value: on ? 1 : 0 }, ctx) : setScalar(LIGHT_CMD.FLOODLIGHT_SWITCH, on ? 1 : 0, ctx, "int-string");
 }
 function directBinary(param, value, ctx) {
   return setScalar(param, value, ctx, "direct-binary");
 }
-function switchFrame(on, ctx) {
-  const cmd = switchCommand(on, ctx);
-  if (!cmd)
-    throw new Error(`light: unknown spotlight switch wire format \u2014 confirm it [${describeDevice(ctx)}]`);
-  return cmd;
-}
 var LIGHT_MEMBERS = {
   /**
    * Whether the lamp is lit RIGHT NOW — the momentary switch, not a setting. Measured on a T8170: 1400
@@ -6894,9 +6881,8 @@ var LIGHT_MEMBERS = {
    * So it reads on whenever any client is watching. The setting a user changes and expects to persist
    * is {@link spotlightEnabled}.
    *
-   * The switch refuses for a reason a value check cannot give — this model's frame SHAPE is unconfirmed —
-   * so `switchFrame` throws that reason and `bindMembers` turns it into the rejection, rather than
-   * letting the generated "not a valid value" blame a boolean that was never the problem.
+   * The switch frame SHAPE is per family ({@link lightSwitchWire}), and the write is `unverifiedFor` the
+   * families it has no shape for.
    */
   isOn: {
     param: LIGHT_CMD.FLOODLIGHT_SWITCH,
@@ -6905,7 +6891,11 @@ var LIGHT_MEMBERS = {
     kind: "boolean",
     provenance: "verified",
     description: "Light on/off (1400) \u2014 lit right now, not a setting: it follows whichever client is streaming. Verified via P2P state readback (3/3); session-scoped behaviour measured live on a T8170.",
-    write: (v, ctx) => switchFrame(asBool(v), ctx),
+    write: (v, ctx) => {
+      const wire = lightSwitchWire(ctx);
+      return wire && switchCommand(asBool(v), wire, ctx);
+    },
+    unverifiedFor: (ctx) => lightSwitchWire(ctx) === void 0,
     writeAs: "set",
     aliases: { on: true, off: false }
   },
@@ -6986,14 +6976,15 @@ var LIGHT = {
    * Only what the member table cannot express: `on`/`off` as no-argument verbs over the same wire as the
    * derived `set`, and the write-only auto-spotlight composite. The verbs stay UNDESCRIBED on purpose —
    * `set` is the method that takes the value, and describing all three would offer one state as three
-   * controls. `async` is what turns `switchFrame`'s throw into the rejection a `Promise<void>`
-   * caller expects, the same shape the derived setter gets from `bindMembers`.
+   * controls. Like `set`, the verbs are absent on a model whose switch shape is unverified.
    */
   actions({ ctx, sink }) {
-    const dispatchSwitch = async (on) => sink.dispatch(switchFrame(on, ctx));
+    const wire = lightSwitchWire(ctx);
     return {
-      on: () => dispatchSwitch(true),
-      off: () => dispatchSwitch(false),
+      ...wire && {
+        on: () => sink.dispatch(switchCommand(true, wire, ctx)),
+        off: () => sink.dispatch(switchCommand(false, wire, ctx))
+      },
       setAutoSpotlight: (on, opts) => sink.dispatch(autoSpotlightCommand(asBool(on), ctx, opts))
     };
   }
@@ -11862,8 +11853,8 @@ function memberCommand(m, action, value, ctx) {
     const claims = action === property2 || member.intentNames?.includes(action) === true;
     if (!claims && aliased === void 0)
       continue;
-    if (member.unverified) {
-      throw new Error(`${m.capability}: ${name} write wire unverified \u2014 confirm it on a device before sending`);
+    if (member.unverified || member.unverifiedFor?.(ctx)) {
+      throw new Error(`${m.capability}: ${name} write wire unverified \u2014 confirm it on a device before sending [${describeDevice(ctx)}]`);
     }
     if (!member.write || !installs(member, ctx))
       continue;
@@ -16388,19 +16379,19 @@ function buildKeyedActuatePayload(id, devicePublicKeyHex, userName, rnd) {
     payload: sealInnerPayload(inner, aesKeyHex, id.deviceSn)
   };
 }
-function keyedPayloadReportCode(json, engage) {
-  if (json?.cmd !== CommandType.P2P_QUERY_STATUS_IN_LOCK)
+function keyedPayloadReportCode(json2, engage) {
+  if (json2?.cmd !== CommandType.P2P_QUERY_STATUS_IN_LOCK)
     return void 0;
-  const payload = json.payload;
+  const payload = json2.payload;
   const slState = engage ? "4" : "3";
   if (payload?.slState !== slState)
     return void 0;
   return typeof payload?.code === "number" ? payload.code : void 0;
 }
-function keyedPayloadSeqMark(json) {
-  if (json?.cmd !== CommandType.CMD_DOORLOCK_P2P_SEQ)
+function keyedPayloadSeqMark(json2) {
+  if (json2?.cmd !== CommandType.CMD_DOORLOCK_P2P_SEQ)
     return void 0;
-  const seq = json.payload?.seq_num;
+  const seq = json2.payload?.seq_num;
   return typeof seq === "number" && Number.isFinite(seq) ? seq : void 0;
 }
 
@@ -17696,8 +17687,8 @@ var P2PSession = class _P2PSession extends EventEmitter2 {
    * `channel`. This is the form the eufy app uses for control commands (confirmed by live capture:
    * floodlight = `{"commandType":1400,"data":{...}}`). Returns `false` if no level-2 key.
    */
-  sendRawLevel2(json, channel, outerCmd = CMD_SET_PAYLOAD) {
-    return this.sendRawLevel2Bytes(Buffer.from(json, "utf-8"), channel, outerCmd);
+  sendRawLevel2(json2, channel, outerCmd = CMD_SET_PAYLOAD) {
+    return this.sendRawLevel2Bytes(Buffer.from(json2, "utf-8"), channel, outerCmd);
   }
   /**
    * Like {@link sendRawLevel2} but the plaintext is a raw byte buffer, not a UTF-8 string. Some
@@ -17805,13 +17796,13 @@ var P2PSession = class _P2PSession extends EventEmitter2 {
       body.writeUInt32LE(channel >>> 0, 0);
       return this.sendRawLevel2Bytes(body, channel, start ? CMD_START_TALKBACK : CMD_STOP_TALKBACK, 8);
     }
-    const json = JSON.stringify({
+    const json2 = JSON.stringify({
       commandType: start ? CMD_START_SPEAK : CMD_END_SPEAK,
       data: { transaction: String(Date.now()) }
     });
     if (this.level2Key)
-      return this.sendRawLevel2(json, channel, CMD_CONTROL_PAYLOAD);
-    this.sendStringPayloadCommand(CMD_CONTROL_PAYLOAD, json, channel);
+      return this.sendRawLevel2(json2, channel, CMD_CONTROL_PAYLOAD);
+    this.sendStringPayloadCommand(CMD_CONTROL_PAYLOAD, json2, channel);
     return true;
   }
   /**
@@ -23736,17 +23727,17 @@ var P2PCommandRouter = class _P2PCommandRouter {
         session.off("data", onData);
       };
       session.on("data", onData);
-      const json = JSON.stringify({ commandType: param, data });
+      const json2 = JSON.stringify({ commandType: param, data });
       this.sendBySessionLevel(sn, {
         l1: ({ session: s, channel: ch }) => {
-          s.sendStringPayloadCommand(P2P_ENVELOPE.CONTROL_PAYLOAD, json, ch);
+          s.sendStringPayloadCommand(P2P_ENVELOPE.CONTROL_PAYLOAD, json2, ch);
           return Promise.resolve();
         },
         l2: async ({ session: s, channel: ch, parentSn }) => {
           if (!await s.awaitLevel2Key(LEVEL2_GRACE_MS, "call")) {
             throw new StationKeyUnavailableError(parentSn);
           }
-          s.sendRawLevel2(json, ch, P2P_ENVELOPE.CONTROL_PAYLOAD);
+          s.sendRawLevel2(json2, ch, P2P_ENVELOPE.CONTROL_PAYLOAD);
         }
       }).catch((e) => {
         cleanup();
@@ -24432,17 +24423,17 @@ var P2PCommandRouter = class _P2PCommandRouter {
    * the session to connect + (for HomeBase) the level-2 key.
    */
   async routeControl(sn, outerCmd, inner) {
-    const json = JSON.stringify(inner);
+    const json2 = JSON.stringify(inner);
     await this.sendBySessionLevel(sn, {
       l1: ({ session, channel }) => {
-        session.sendStringPayloadCommand(outerCmd, json, channel);
+        session.sendStringPayloadCommand(outerCmd, json2, channel);
         return Promise.resolve();
       },
       l2: async ({ session, channel }) => {
         if (!await session.awaitLevel2Key(LEVEL2_GRACE_MS, "call")) {
           throw new Error(`level-2 key not ready for ${sn} \u2014 cannot route HomeBase command`);
         }
-        session.sendRawLevel2(json, channel, outerCmd);
+        session.sendRawLevel2(json2, channel, outerCmd);
       }
     });
   }
@@ -25058,7 +25049,7 @@ var PtcsFramer = class {
 // dist/transport/rtc/scall-sdp.js
 var HUB_SDP_MID = "2";
 var ANKER_MAX_MESSAGE_SIZE = 262144;
-function scallJsonToSdp(json, now2 = Date.now) {
+function scallJsonToSdp(json2, now2 = Date.now) {
   let sdp = "";
   sdp += "v=0\r\n";
   sdp += `o=- ${Math.floor(now2())} 1 IN IP4 127.0.0.1\r
@@ -25073,42 +25064,42 @@ function scallJsonToSdp(json, now2 = Date.now) {
   sdp += `a=mid:${HUB_SDP_MID}\r
 `;
   sdp += "a=ice-options:trickle\r\n";
-  if (json.ice?.ufrag)
-    sdp += `a=ice-ufrag:${json.ice.ufrag}\r
+  if (json2.ice?.ufrag)
+    sdp += `a=ice-ufrag:${json2.ice.ufrag}\r
 `;
-  if (json.ice?.pwd)
-    sdp += `a=ice-pwd:${json.ice.pwd}\r
+  if (json2.ice?.pwd)
+    sdp += `a=ice-pwd:${json2.ice.pwd}\r
 `;
-  if (json.ice?.fingerprint) {
-    const fp = json.ice.fingerprint.replace(/(.{2})(?=.)/g, "$1:");
-    sdp += `a=fingerprint:${json.ice.fingerprint_type ?? "sha-256"} ${fp}\r
+  if (json2.ice?.fingerprint) {
+    const fp = json2.ice.fingerprint.replace(/(.{2})(?=.)/g, "$1:");
+    sdp += `a=fingerprint:${json2.ice.fingerprint_type ?? "sha-256"} ${fp}\r
 `;
   }
-  sdp += `a=setup:${json.setup ?? "actpass"}\r
+  sdp += `a=setup:${json2.setup ?? "actpass"}\r
 `;
   sdp += "a=sctp-port:5000\r\n";
   sdp += `a=max-message-size:${ANKER_MAX_MESSAGE_SIZE}\r
 `;
-  for (const c of json.candidate ?? [])
+  for (const c of json2.candidate ?? [])
     sdp += `a=candidate:${c}\r
 `;
   return sdp;
 }
 function sdpToScallJson(sdp) {
-  const json = { ice: { ufrag: "", pwd: "", fingerprint: "" } };
+  const json2 = { ice: { ufrag: "", pwd: "", fingerprint: "" } };
   const setup = sdp.match(/a=setup:([^\r\n]+)/)?.[1];
   if (setup && setup !== "actpass")
-    json.setup = setup;
+    json2.setup = setup;
   const ufrag = sdp.match(/a=ice-ufrag:([^\r\n]+)/)?.[1];
   if (ufrag)
-    json.ice.ufrag = ufrag;
+    json2.ice.ufrag = ufrag;
   const pwd = sdp.match(/a=ice-pwd:([^\r\n]+)/)?.[1];
   if (pwd)
-    json.ice.pwd = pwd;
+    json2.ice.pwd = pwd;
   const fp = sdp.match(/a=fingerprint:([^\s]+)\s+([^\r\n]+)/);
   if (fp?.[2]) {
-    json.ice.fingerprint_type = fp[1];
-    json.ice.fingerprint = fp[2].replace(/:/g, "");
+    json2.ice.fingerprint_type = fp[1];
+    json2.ice.fingerprint = fp[2].replace(/:/g, "");
   }
   const candidates = [];
   for (const line of sdp.split(/\r\n|\r|\n/)) {
@@ -25117,8 +25108,8 @@ function sdpToScallJson(sdp) {
       candidates.push(m[1]);
   }
   if (candidates.length)
-    json.candidate = candidates;
-  return json;
+    json2.candidate = candidates;
+  return json2;
 }
 function iceCandidateType(candidate) {
   return candidate.match(/typ (\w+)/)?.[1] ?? "unknown";
@@ -27630,10 +27621,10 @@ function deriveBodyKey(requestId, ecode) {
   const hex = createHmac5("sha256", requestId).update(msg, "utf-8").digest("hex");
   return Buffer.from(hex.slice(0, 16), "ascii");
 }
-function encryptBody2(key, json) {
+function encryptBody2(key, json2) {
   const nonce = randomBytes6(12);
   const cipher = createCipheriv7("aes-128-gcm", key, nonce);
-  const ciphertext = Buffer.concat([cipher.update(Buffer.from(json, "utf-8")), cipher.final()]);
+  const ciphertext = Buffer.concat([cipher.update(Buffer.from(json2, "utf-8")), cipher.final()]);
   return Buffer.concat([nonce, ciphertext, cipher.getAuthTag()]).toString("base64");
 }
 function decryptReply(key, resultB64) {
@@ -28822,11 +28813,11 @@ var PushClient = class _PushClient extends EventEmitter13 {
     const data = {};
     for (const kv of object?.appData ?? []) {
       if (kv.key === "payload") {
-        const json = readNullTerminated(Buffer.from(kv.value, "base64"));
+        const json2 = readNullTerminated(Buffer.from(kv.value, "base64"));
         try {
-          data.payload = JSON.parse(json);
+          data.payload = JSON.parse(json2);
         } catch {
-          data.payload = json;
+          data.payload = json2;
         }
       } else {
         data[kv.key] = kv.value;
@@ -29340,7 +29331,71 @@ function cameraInfo(facts, qualifier, value) {
     return typeof spec.value === "string" && spec.value === reported;
   if (qualifier === "RE")
     return typeof spec.regex === "string" && re(spec.regex, reported);
-  return false;
+  if (qualifier !== "json_match" || !spec.json_match || typeof spec.json_match !== "object")
+    return false;
+  const target = json(reported);
+  return !!target && typeof target === "object" && !Array.isArray(target) && jsonMatch(target, spec.json_match);
+}
+var content = (v) => v === null || v === void 0 || typeof v === "object" ? void 0 : String(v);
+var json = (text2) => {
+  try {
+    return JSON.parse(text2);
+  } catch {
+    return void 0;
+  }
+};
+var asInt = (v, fallback) => {
+  const n = Number.parseInt(String(v), 10);
+  return Number.isNaN(n) ? fallback : n;
+};
+var ASSOCIATED = {
+  /** `true` once `APP_CMD_SET_SILENT_OTA_SWITCH` (6287) is reported. */
+  is_support_silent_ota_switch: (p) => p[6287] === void 0 ? void 0 : "true",
+  /** `APP_CMD_HB3_AI_Empowerment` (1299): its JSON value, else the value as an integer (0 when none). */
+  ai_empower: (p) => {
+    const v = p[1299];
+    if (v === void 0)
+      return void 0;
+    const parsed = json(v);
+    if (parsed === void 0)
+      return String(asInt(v, 0));
+    return content(parsed) ?? JSON.stringify(parsed);
+  },
+  /** `APP_CMD_GET_POWER_SUPPLY_MODE` (6445): its JSON `power_source`, else `source`, as an integer; 1 when empty. */
+  device_power_supply_mode: (p) => {
+    const v = p[6445];
+    if (v === void 0)
+      return void 0;
+    if (v === "")
+      return "1";
+    const parsed = json(v);
+    return parsed === void 0 ? void 0 : String(asInt(parsed?.power_source ?? parsed?.source, 1));
+  }
+};
+function jsonMatch(target, match) {
+  const checks = [];
+  const keys = (k) => Array.isArray(match[k]) ? match[k].map(content).filter((x) => x !== void 0) : [];
+  const pairs = (k) => match[k] && typeof match[k] === "object" ? Object.entries(match[k]).map(([key, v]) => [key, content(v)]) : [];
+  for (const k of keys("contains_key"))
+    checks.push(Object.hasOwn(target, k));
+  for (const k of keys("not_contains_key"))
+    checks.push(!Object.hasOwn(target, k));
+  const valued = (k, test) => {
+    for (const [key, expected] of pairs(k)) {
+      const actual = content(target[key]);
+      checks.push(expected !== void 0 && actual !== void 0 && test(actual, expected));
+    }
+  };
+  valued("value_equals", (a, e) => a === e);
+  valued("value_not_equals", (a, e) => a !== e);
+  valued("value_regex", (a, e) => {
+    try {
+      return new RegExp(e).test(a);
+    } catch {
+      return false;
+    }
+  });
+  return match.mode === "any" ? checks.some(Boolean) : checks.every(Boolean);
 }
 function condition(c, facts) {
   const station = facts.stationSerial ?? facts.serial ?? "";
@@ -29358,15 +29413,10 @@ function condition(c, facts) {
       return re(c.value, facts.serial ?? "");
     case "user_country":
       return re(c.value, facts.country ?? "");
-    case "user_domain":
-      return re(c.value, "");
     case "sdk_version":
       return version(APP_SDK_VERSION, c.qualifier, c.value);
     case "associated_field":
-    case "parent_associated_field":
-      return compare("", c.qualifier, c.value);
-    case "user_permission":
-      return c.qualifier === "in";
+      return compare(ASSOCIATED[c.propId ?? ""]?.(facts.params ?? {}) ?? "", c.qualifier, c.value);
     case "camera_info":
       return cameraInfo(facts, c.qualifier, c.value);
     default:
@@ -29399,7 +29449,7 @@ function resolveThing(td, facts) {
     const p = td.properties[chosen];
     if (!p || !conditionsPass(p.availableConditions, facts))
       continue;
-    properties[base] = conditionsPass(p.writeConditions, facts) ? p : { ...p, accessMode: "R" };
+    properties[base] = p;
   }
   const available = (entries) => {
     const out = /* @__PURE__ */ Object.create(null);
@@ -29450,7 +29500,6 @@ function property(p) {
     ...num2(specs.step) !== void 0 ? { step: num2(specs.step) } : {},
     ...optStr(specs.unit) !== void 0 ? { unit: str3(specs.unit) } : {},
     readConditions: conditions(p.read_conditions),
-    writeConditions: conditions(p.write_conditions),
     availableConditions: conditions(p.available_conditions)
   };
 }