@mega-yfue/eufy-sdk 0.5.0-beta.70 → 0.5.0-beta.72

package/dist/core/contracts.d.ts

@@ -883,6 +883,7 @@ export interface MediaProvider {
      */
     p2pQuery?(subCmd: number, opts?: {
         timeoutMs?: number;
+        payload?: Record<string, unknown>;
     }): Promise<Record<string, unknown>>;
     /**
      * Generic control-payload request/reply query: send a `CONTROL_PAYLOAD` (1700) `{commandType,data}`

package/dist/index.js

@@ -3658,6 +3658,7 @@ var isNvrT8N00 = (ctx) => ctx.model === "T8N00";
 var isDoorbellT8223 = (ctx) => ctx.model === "T8223";
 var isAiotVacuum = (ctx) => ctx.category !== "eufy_home_tuya";
 var isTuyaVacuum = (ctx) => ctx.category === "eufy_home_tuya";
+var isVideoSmartLock = (ctx) => ctx.deviceType === DeviceType.LOCK_8530;
 
 // dist/model/capabilities/rtsp.js
 var RTSP_PARAM = {
@@ -7434,9 +7435,24 @@ var LOCK_SETTING_ID = {
   /** One-touch rear-lock toggle. Structurally confirmed via the app's own JS (2026-07-18) — see the module doc. */
   ONE_TOUCH_REAR_LOCK: 11
 };
+var VIDEO_LOCK_CMD = { ACTUATE: 1961, STATUS: 1955, NOTIFY: 1351 };
 function actuate(engage, ctx, sink) {
-  if (!ctx.adminUserId || !ctx.shortUserId) {
-    return Promise.reject(new Error(`lock: missing member identity (admin_user_id/short_user_id) [${describeDevice(ctx)}]`));
+  if (!ctx.adminUserId || !ctx.shortUserId || isVideoSmartLock(ctx) && !ctx.accountName) {
+    return Promise.reject(new Error(`lock: missing member identity (admin_user_id/short_user_id, and user name on video locks) [${describeDevice(ctx)}]`));
+  }
+  if (isVideoSmartLock(ctx)) {
+    return sink.dispatch({
+      kind: "set-payload",
+      cmd: VIDEO_LOCK_CMD.ACTUATE,
+      channel: ctx.channel,
+      mValue3: 0,
+      payload: {
+        shortUserId: ctx.shortUserId,
+        slOperation: engage ? 1 : 0,
+        userId: ctx.adminUserId,
+        userName: ctx.accountName
+      }
+    });
   }
   return sink.dispatch({
     kind: "ff09-actuate",
@@ -7459,7 +7475,31 @@ function settingToggle(settingId, name, enabled, ctx, sink) {
     value: enabled
   });
 }
-var overP2p = (ctx) => ctx.hasP2p === true;
+var overP2p = (ctx) => ctx.hasP2p === true && !isVideoSmartLock(ctx);
+function actuationAvailable(ctx) {
+  return !isVideoSmartLock(ctx) || ctx.stationSerial?.startsWith("T8030") === true;
+}
+async function refreshStatus(query, timezone) {
+  const payload = await query(VIDEO_LOCK_CMD.STATUS, {
+    payload: { timezone }
+  });
+  if (payload.code !== 0)
+    throw new Error(`lock.refreshStatus: device result ${String(payload.code)}`);
+  return nativeState(payload.slState);
+}
+function nativeState(raw) {
+  if (raw === "3")
+    return false;
+  if (raw === "4")
+    return true;
+  return void 0;
+}
+function nativeReport(signal) {
+  if (signal.source !== "p2p-frame" || !isVideoSmartLock(signal) || signal.commandId !== VIDEO_LOCK_CMD.NOTIFY || signal.json?.cmd !== VIDEO_LOCK_CMD.STATUS)
+    return void 0;
+  const report = signal.json.payload;
+  return report?.code === 0 ? report : void 0;
+}
 var LOCK_MEMBERS = {
   /**
    * The lock's own state, verified on param 6000: "4" = locked, "3" = unlocked.
@@ -7501,10 +7541,10 @@ var LOCK_MEMBERS = {
     provenance: "verified",
     description: "Lock signal strength (verified: param 1141 = RSSI)."
   },
-  /** Lock the deadbolt/door. Fire-and-forget — rejects only on missing member identity, never on a device timeout. */
-  lock: method(({ ctx, sink }) => () => actuate(true, ctx, sink), "Lock the deadbolt/door."),
-  /** Unlock the deadbolt/door. Fire-and-forget — rejects only on missing member identity. */
-  unlock: method(({ ctx, sink }) => () => actuate(false, ctx, sink), "Unlock the deadbolt/door."),
+  /** Lock the deadbolt/door. Resolves after sending; does not confirm physical state. */
+  lock: method(({ ctx, sink }) => () => actuate(true, ctx, sink), "Lock the deadbolt/door.", actuationAvailable),
+  /** Unlock the deadbolt/door. Resolves after sending; does not confirm physical state. */
+  unlock: method(({ ctx, sink }) => () => actuate(false, ctx, sink), "Unlock the deadbolt/door.", actuationAvailable),
   /**
    * Read-modify-write the auto-lock setting: the transport GETs the device's current settings, changes
    * only `enabled` (+ `delaySeconds` if given — otherwise the current delay is preserved), and writes the
@@ -7525,7 +7565,7 @@ var LOCK_MEMBERS = {
       enabled,
       delaySeconds
     });
-  }, "Read-modify-write the auto-lock setting, preserving the fields it does not change."),
+  }, "Read-modify-write the auto-lock setting, preserving the fields it does not change.", (ctx) => !isVideoSmartLock(ctx)),
   /**
    * Toggle Rain Mode — a pure blind write, unlike `setAutoLock`: the compact frame carries only this one
    * field, so there is no GET pass and it is fire-and-forget. Confirmed on-device end-to-end in both
@@ -7623,6 +7663,15 @@ var LOCK_MEMBERS = {
     description: "One-touch rear locking (setting-id 11). Wire shape confirmed in the app's own JS, NOT captured.",
     write: (v, ctx) => settingToggleCommand(LOCK_SETTING_ID.ONE_TOUCH_REAR_LOCK, v, ctx)
   },
+  /** Read the current device-reported state; undefined means no settled locked/unlocked state. */
+  refreshStatus: {
+    ...provided("media", (media, { ctx }) => {
+      const query = media.p2pQuery?.bind(media);
+      const timezone = ctx.timezone;
+      return isVideoSmartLock(ctx) && timezone && query ? () => refreshStatus(query, timezone) : void 0;
+    }, "Read the current lock state from the device."),
+    answers: true
+  },
   /**
    * Read the device's current auto-lock settings via a live `GET_SETTINGS` round-trip — the SAME read
    * `setAutoLock` does internally, exposed standalone with no write attached. Works over BOTH transports.
@@ -7632,7 +7681,7 @@ var LOCK_MEMBERS = {
    * though it takes no arguments — offering it as one would run a round-trip and discard the answer.
    */
   getAutoLockState: {
-    ...provided("ff09Settings", (f) => () => f.getAutoLockState(), "Read the current auto-lock settings via a live round-trip."),
+    ...provided("ff09Settings", (f, { ctx }) => isVideoSmartLock(ctx) ? void 0 : () => f.getAutoLockState(), "Read the current auto-lock settings via a live round-trip."),
     answers: true
   }
 };
@@ -7659,6 +7708,17 @@ var LOCK = {
   description: "Smart-lock locked/unlocked state and battery.",
   members: LOCK_MEMBERS,
   properties: propertiesOf(LOCK_MEMBERS),
+  decodeState(signal) {
+    const report = nativeReport(signal);
+    if (!report)
+      return null;
+    const params = {};
+    if (nativeState(report.slState) !== void 0)
+      params[6e3] = String(report.slState);
+    if (report.slBattery !== void 0)
+      params[6001] = String(report.slBattery);
+    return { params };
+  },
   // Lock state is reported via param 6000 (verified: 4=locked, 3=unlocked); the model name (lock/safe) is a
   // signal, and every lock-codec device has the lock capability as its baseline.
   detection: { evidenceParams: [6e3], modelHints: [/lock/i, /safe/i], codecs: ["lock"] },
@@ -22616,7 +22676,7 @@ var P2PCommandRouter = class _P2PCommandRouter {
       }, timeoutMs);
       const onData = (f) => {
         const j = f.json;
-        if (j?.cmd === subCmd && j.payload && typeof j.payload === "object") {
+        if (f.channel === channel && f.commandId === CommandType.CMD_NOTIFY_PAYLOAD && j?.cmd === subCmd && j.payload && typeof j.payload === "object") {
           cleanup();
           resolve(j.payload);
         }
@@ -22627,7 +22687,11 @@ var P2PCommandRouter = class _P2PCommandRouter {
       };
       session.on("data", onData);
       try {
-        session.sendSetPayload(subCmd, {}, { accountId, channel });
+        if (opts.payload) {
+          if (!session.sendControlLevel2(subCmd, channel, accountId, opts.payload, 0))
+            throw new Error("p2p query send failed");
+        } else
+          session.sendSetPayload(subCmd, {}, { accountId, channel });
       } catch (e) {
         cleanup();
         reject(e instanceof Error ? e : new Error(String(e)));
@@ -24489,6 +24553,10 @@ var RtcSession = class extends EventEmitter11 {
    * `connect()` still waiting for the signalling auth is rejected and its timer stopped.
    */
   close() {
+    this.shutdown();
+  }
+  /** {@link RtcSession.close}, with the failure that ended the session handed to `close` when one did. */
+  shutdown(err) {
     if (this.closed)
       return;
     this.closed = true;
@@ -24501,7 +24569,7 @@ var RtcSession = class extends EventEmitter11 {
     this.signaling.close();
     this.peer.close();
     this.settleAuth(new Error("RTC session closed while waiting for signalling auth"));
-    this.announceClose();
+    this.announceClose(err);
   }
   /**
    * Trickle one local candidate, or the empty end-of-candidates. The native peer can report one after the
@@ -24513,11 +24581,11 @@ var RtcSession = class extends EventEmitter11 {
       return;
     this.signaling.sendInfoCandidate(candidate);
   }
-  announceClose() {
+  announceClose(err) {
     if (this.closeAnnounced)
       return;
     this.closeAnnounced = true;
-    this.emit("close");
+    this.emit("close", err);
   }
   waitForAuth() {
     if (this.authOk)
@@ -24577,7 +24645,14 @@ var RtcSession = class extends EventEmitter11 {
     const status = payload.status;
     if (status === 100 && payload.turn) {
       this.turn = payload.turn;
-      await this.peer.init(payload.turn);
+      try {
+        await this.peer.init(payload.turn);
+      } catch (e) {
+        const err = e instanceof Error ? e : new Error(String(e));
+        this.emit("error", err);
+        this.shutdown(err);
+        return;
+      }
       return;
     }
     if (status === 200) {
@@ -24913,9 +24988,9 @@ var RtcCommandRouter = class {
   }
   /**
    * One bounded bring-up: the session is up when its command channel opens, and it fails, with the
-   * session closed and every listener gone, when `connect()` throws, the session closes first, or
-   * {@link CONNECT_TIMEOUT_MS} passes. A single promise, so an early failure cannot leave a second one
-   * rejecting unheard.
+   * session closed and every listener gone, when `connect()` throws, the session closes first (rejecting
+   * with the failure that closed it, when it carries one), or {@link CONNECT_TIMEOUT_MS} passes. A single
+   * promise, so an early failure cannot leave a second one rejecting unheard.
    */
   bringUp(sn, session) {
     return new Promise((resolve, reject) => {
@@ -24939,7 +25014,7 @@ var RtcCommandRouter = class {
         }
       };
       const onConnected = () => finish();
-      const onClose = () => finish(new Error(`rtc: ${sn} session closed before the command channel opened`));
+      const onClose = (err) => finish(err ?? new Error(`rtc: ${sn} session closed before the command channel opened`));
       const timer = setTimeout(() => finish(new Error(`rtc: ${sn} did not come up within ${CONNECT_TIMEOUT_MS2}ms`)), CONNECT_TIMEOUT_MS2);
       session.once("connected", onConnected);
       session.once("close", onClose);
@@ -29021,7 +29096,11 @@ var EufyMega = class extends EventEmitter14 {
     this.emit("p2p", f);
     const caps = this.registry.capabilitiesForFrame(stationSn, f.channel);
     const deviceSn = this.registry.serialForFrame(stationSn, f.channel);
-    const signal = { source: "p2p-frame", ...f };
+    const signal = {
+      source: "p2p-frame",
+      ...f,
+      deviceType: deviceSn ? this.registry.require(deviceSn).raw?.device_type : void 0
+    };
     if (f.params)
       this.applyRealtimeState(deviceSn, f.params);
     this.applyRealtimeReport(deviceSn, decodeState(signal, caps));
@@ -30289,10 +30368,13 @@ var EufyMega = class extends EventEmitter14 {
     const rawChannel = raw.device_channel;
     const channel = typeof rawChannel === "number" ? rawChannel : 0;
     const member = raw.member ?? {};
+    const parent = this.registry.list().find((d) => d.sn === rec.parentSn);
+    const parentRaw = parent?.raw;
     const resolved = resolveDevice(rec);
     const dpCatalog = (resolved.codec === "vacuum" || resolved.codec === "mower") && rec.model ? await this.fetchDpCatalog(rec.model) : void 0;
     return {
       channel,
+      timezone: recordString(parentRaw ?? {}, "time_zone"),
       codec: resolved.codec,
       deviceType: rec.deviceType,
       model: rec.model,