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

package/dist/model/capabilities/lock.d.ts

@@ -1,6 +1,6 @@
 import { type Surface } from "./members.js";
 import type { AvailabilityContext, CapabilityModule, CommandContext } from "./types.js";
-import type { Command, AutoLockSnapshot } from "../../core/contracts.js";
+import type { Command, AutoLockSnapshot, MediaProvider } from "../../core/contracts.js";
 /**
  * Setting-id selectors for the compact `ff09-setting-toggle` write — this capability's OWN wire
  * vocabulary, named not inlined per the capability wire-id convention, so `setRainMode`
@@ -107,10 +107,14 @@ export declare const LOCK_MEMBERS: {
         readonly provenance: "verified";
         readonly 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. */
-    readonly lock: import("./members.js").MethodMember<() => Promise<void>>;
-    /** Unlock the deadbolt/door. Fire-and-forget — rejects only on missing member identity. */
-    readonly unlock: import("./members.js").MethodMember<() => Promise<void>>;
+    /** Lock the deadbolt/door. Resolves after sending; does not confirm physical state. */
+    readonly lock: import("./members.js").MethodMember<() => Promise<void>> & {
+        available: (ctx: CommandContext) => boolean;
+    };
+    /** Unlock the deadbolt/door. Resolves after sending; does not confirm physical state. */
+    readonly unlock: import("./members.js").MethodMember<() => Promise<void>> & {
+        available: (ctx: CommandContext) => boolean;
+    };
     /**
      * 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
@@ -120,7 +124,9 @@ export declare const LOCK_MEMBERS: {
      * **Unlike `lock`/`unlock` this can reject on a device TIMEOUT**, not just missing identity — the GET
      * step is a genuine precondition, so this one is not fire-and-forget.
      */
-    readonly setAutoLock: import("./members.js").MethodMember<(enabled: boolean, delaySeconds?: number) => Promise<void>>;
+    readonly setAutoLock: import("./members.js").MethodMember<(enabled: boolean, delaySeconds?: number) => Promise<void>> & {
+        available: (ctx: CommandContext) => boolean;
+    };
     /**
      * 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
@@ -220,6 +226,14 @@ export declare const LOCK_MEMBERS: {
         readonly description: "One-touch rear locking (setting-id 11). Wire shape confirmed in the app's own JS, NOT captured.";
         readonly write: (v: string | number | boolean, ctx: CommandContext) => Command;
     };
+    /** Read the current device-reported state; undefined means no settled locked/unlocked state. */
+    readonly refreshStatus: {
+        readonly needs: "media";
+        readonly provided: (provider: MediaProvider, deps: import("./members.js").MemberDeps) => (() => Promise<boolean | undefined>) | undefined;
+        readonly description: string;
+        readonly requiredCapabilities?: readonly import("../types.js").Capability[];
+        readonly 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.
@@ -230,7 +244,7 @@ export declare const LOCK_MEMBERS: {
      */
     readonly getAutoLockState: {
         readonly needs: "ff09Settings";
-        readonly provided: (provider: import("../../core/contracts.js").Ff09SettingsReader, deps: import("./members.js").MemberDeps) => () => Promise<AutoLockSnapshot>;
+        readonly provided: (provider: import("../../core/contracts.js").Ff09SettingsReader, deps: import("./members.js").MemberDeps) => (() => Promise<AutoLockSnapshot>) | undefined;
         readonly description: string;
         readonly requiredCapabilities?: readonly import("../types.js").Capability[];
         readonly answers: true;

package/dist/model/capabilities/types.d.ts

@@ -60,6 +60,8 @@ export type ProductLine = "security" | "life" | "clean" | "print" | "display" |
  * `p2p-frame` shape of {@link InboundSignal}.
  */
 export interface CapabilityFrame {
+    /** Cloud device type resolved from the reporting station/channel. */
+    deviceType?: number;
     stationSn: string;
     commandId: number;
     channel: number;
@@ -255,6 +257,8 @@ export interface AvailabilityContext {
     stationDeviceType?: number;
 }
 export interface CommandContext extends AvailabilityContext {
+    /** Vendor-formatted timezone reported by the station; never inferred from the host. */
+    timezone?: string;
     /** Device channel (0 for standalone, `device_channel` on a HomeBase). */
     channel: number;
     /** eufy DeviceType, when known. */

package/dist/model/device-family.d.ts

@@ -78,3 +78,5 @@ export declare const isAiotVacuum: (ctx: FamilyContext) => boolean;
  * vacuums receive the same write actions as AIoT ones, routed by the facade's `routeCommand`.
  */
 export declare const isTuyaVacuum: (ctx: FamilyContext) => boolean;
+/** Video Smart Lock S330, identified by its distinct cloud device type. */
+export declare const isVideoSmartLock: (ctx: FamilyContext) => boolean;

package/dist/transport/p2p/command-router.d.ts

@@ -548,6 +548,7 @@ export declare class P2PCommandRouter {
      */
     p2pQuery(sn: string, subCmd: number, opts?: {
         timeoutMs?: number;
+        payload?: Record<string, unknown>;
     }): Promise<Record<string, unknown>>;
     /**
      * **Generic control-payload request/reply query.** Sends a `CONTROL_PAYLOAD` (1700) `{commandType,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mega-yfue/eufy-sdk",
-  "version": "0.5.0-beta.70",
+  "version": "0.5.0-beta.71",
   "description": "One typed TypeScript client for the Anker eufy v6 cloud — capability-driven devices, realtime events over P2P/MQTT/push, and live media",
   "license": "Apache-2.0",
   "author": "mega-yfue",