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

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/dist/transport/rtc/command-router.d.ts

@@ -113,9 +113,9 @@ export declare class RtcCommandRouter {
     private stationSession;
     /**
      * 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.
      */
     private bringUp;
     /**

package/dist/transport/rtc/session.d.ts

@@ -15,7 +15,8 @@
  *
  * The command data channel is the session: `close` fires once, when the channel closes, the peer fails,
  * the signalling socket drops or {@link RtcSession.close} is called, even while the peer connection is
- * nominally up.
+ * nominally up. A peer that cannot be built when the hub grants the relay ends the session there: the
+ * failure is emitted as `error` and `close` fires carrying it.
  *
  * A session whose peer is a {@link RtcPeerOptions.mediaTrack} peer has no command channel: `close` fires
  * when the peer fails or closes, and the video track's packets are emitted as `rtp`.
@@ -32,7 +33,8 @@ export interface RtcSessionOptions extends RtcSignalingOptions {
 }
 export interface RtcSessionEvents {
     connected: [];
-    close: [];
+    /** The session ended; `err` is the failure that ended it, when one did. */
+    close: [err?: Error];
     error: [err: Error];
     /** A reassembled command or notify frame: portal packet bytes + the link type it arrived on. */
     commandData: [frame: Buffer, linkType: number];
@@ -73,6 +75,8 @@ export declare class RtcSession extends EventEmitter<RtcSessionEvents> {
      * `connect()` still waiting for the signalling auth is rejected and its timer stopped.
      */
     close(): void;
+    /** {@link RtcSession.close}, with the failure that ended the session handed to `close` when one did. */
+    private shutdown;
     /**
      * Trickle one local candidate, or the empty end-of-candidates. The native peer can report one after the
      * signalling socket has closed, and sending then throws inside a native callback, where the throw can't

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mega-yfue/eufy-sdk",
-  "version": "0.5.0-beta.70",
+  "version": "0.5.0-beta.72",
   "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",