@mega-yfue/eufy-sdk 0.5.0-beta.51 → 0.5.0-beta.53

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

@@ -112,8 +112,11 @@ export declare const ARMING_CMD: {
      */
     readonly SET_ALL_ACTION: 1255;
 };
-/** The guard modes whose device notification is read and written: both replayed on a T8010. */
-export type DeviceNotificationMode = Extract<AlarmDelayMode, "home" | "away">;
+/**
+ * The guard modes whose device notification is read and written. Home and away are replayed on a T8010;
+ * `custom1` (wire 3) is captured on a T8170, whose own params report it on 1148.
+ */
+export type DeviceNotificationMode = Extract<ArmingMode, "home" | "away" | "custom1">;
 /**
  * Alarm-delay durations the app's OWN picker UI offers — `AlarmDelaySeconds` is both the const
  * value-object (`AlarmDelaySeconds.sec45`) and the union type of its values, so callers pass the
@@ -237,7 +240,8 @@ export declare const ARMING_MEMBERS: {
     /**
      * Whether the device on `channel` sends a push notification in `mode`: its {@link DEVICE_NOTIFY_FLAG}
      * in the action table the station reports for that mode. `undefined` where the station reports no table
-     * or the table does not list `channel`. A device's channel is `EufyDevice.channel`.
+     * or the table does not list `channel`. A standalone camera answers from its own 1225/1239/1148 flags,
+     * for its own channel only. A device's channel is `EufyDevice.channel`.
      */
     readonly deviceNotification: import("./members.js").MethodMember<(mode: DeviceNotificationMode, channel: number) => boolean | undefined> & {
         available: (ctx: CommandContext) => boolean;
@@ -245,9 +249,11 @@ export declare const ARMING_MEMBERS: {
     /**
      * Turn the push notification of the device on `channel` on or off in `mode` (cmd
      * {@link ARMING_CMD.SET_ALL_ACTION}): the station's reported table written back with that one flag
-     * changed. Rejects, sending nothing, where the table does not list `channel`. A write builds on the last
-     * one sent for that mode until the station reports a table observed 15 s after it, so a second write does
-     * not revert it; a write whose dispatch rejects is not built on.
+     * changed. A standalone camera is sent a one-entry `{mode_id, devices}` table built from its own flags,
+     * for its own channel only. Rejects, sending nothing, where the table does not list `channel`. A write
+     * builds on the last one sent for that mode until the device reports a table (`${mode}Action` on a
+     * standalone camera) observed 15 s after it, so a second write does not revert it; a write whose dispatch
+     * rejects is not built on.
      */
     readonly setDeviceNotification: import("./members.js").MethodMember<(mode: DeviceNotificationMode, channel: number, on: boolean) => Promise<void>> & {
         available: (ctx: CommandContext) => boolean;

package/dist/transport/tuya/client.d.ts

@@ -81,10 +81,11 @@ export declare class TuyaClient {
      */
     login(eufyUserId: string, phoneCode?: string): Promise<TuyaLoginResult>;
     /**
-     * READ/dump a device's cached data-points (`smartlife.m.device.cache.dp.get`).
-     * Builds the request without needing a working signer; the signer is only exercised on send.
+     * READ a device's current data-points (`smartlife.m.device.dp.get`). The envelope's `result` is a
+     * flat `{ "<dpId>": value }` map. Builds the request without needing a working signer; the signer is
+     * only exercised on send.
      */
-    getDeviceDps<T = unknown>(devId: string, dpCacheType?: number): Promise<TuyaEnvelope<T>>;
+    getDeviceDps<T = unknown>(devId: string): Promise<TuyaEnvelope<T>>;
     /**
      * CONTROL: publish data-points to a device (`smartlife.m.device.dp.publish`). `dps` is
      * `{ "<dpId>": <value> }`. `gwId` is the gateway/parent id (equals `devId` for a standalone gw).

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

@@ -32,9 +32,9 @@ export declare class TuyaCommandRouter {
     /** Promise that resolves once Tuya login has completed. Reset by {@link bind}. */
     private loginOnce;
     /**
-     * eufy SN → Tuya device ids, populated by the facade via {@link registerDevice}.
-     * The facade extracts the Tuya id from the `raw` device record fields (`tuya_uuid`,
-     * `tuya_virtual_id`, `tuya_device_id`, `virtualId`) and registers it once the device list loads.
+     * eufy SN → Tuya device ids, populated via {@link registerDevice} once the device list loads.
+     * The Tuya id is the record's first non-empty `tuya_uuid` / `tuya_virtual_id` / `tuya_device_id` /
+     * `virtualId`, or the device's serial when the record carries none of them.
      */
     private readonly snMap;
     constructor(config?: TuyaCommandRouterConfig);
@@ -48,21 +48,17 @@ export declare class TuyaCommandRouter {
      */
     bind(userId: string, regionShard?: string, isoCode?: string): void;
     /**
-     * Register a eufy SN → Tuya devId mapping. Called by the facade for each `eufy_home_tuya`
-     * device after the cloud device list loads. The facade extracts the Tuya id from the device's
-     * raw record (`tuya_uuid` / `tuya_virtual_id` / `tuya_device_id` / `virtualId` fields).
-     * `gwId` defaults to `devId` — standalone devices share the two.
+     * Register a eufy SN → Tuya devId mapping for an `eufy_home_tuya` device. `devId` is the record's
+     * first non-empty `tuya_uuid` / `tuya_virtual_id` / `tuya_device_id` / `virtualId`, or the device's
+     * serial when the record carries none of them. `gwId` defaults to `devId` — standalone devices
+     * share the two.
      */
     registerDevice(sn: string, devId: string, gwId?: string): void;
     private ensureLoggedIn;
     /**
-     * Fetch a device's cached DPs from the Tuya cloud (`smartlife.m.device.cache.dp.get`) and deliver
-     * the raw DP map to the caller. Used for initial state hydration after MQTT subscribe — gets the
-     * last-known state without waiting for the first realtime push.
-     *
-     * The response shape from `getDeviceDps` is not yet pinned from a live capture. The defensive
-     * extraction tries both `result.dps` (a nested map) and bare `result` (a flat map), and returns
-     * `null` when neither yields a non-empty record.
+     * Read a device's current DPs from the Tuya cloud (`smartlife.m.device.dp.get`) and answer the DP
+     * map: the reply's flat `result`, kept to integer DP keys with scalar values. Answers `null` for an
+     * unregistered device, a failed reply, or a reply with no DPs.
      */
     fetchDps(sn: string): Promise<Record<string, unknown> | null>;
     /**

package/dist/transport/tuya/request.d.ts

@@ -140,10 +140,10 @@ export declare function sendApiRequest<T = unknown>(params: Record<string, strin
  */
 export declare function buildPublishDpsAction(devId: string, gwId: string, dps: Record<string, unknown>): TuyaAction;
 /**
- * READ/dump: fetch a device's cached data-points. Action `smartlife.m.device.cache.dp.get` v2.0.
- * TODO(verify): `dpCacheType` default (1) was not pinned from the capture.
+ * READ: a device's current data-points. Action `smartlife.m.device.dp.get` v1.0, postData `{ devId }`.
+ * The reply `result` is a flat `{ "<dpId>": value }` map.
  */
-export declare function buildGetDeviceDpsAction(devId: string, dpCacheType?: number): TuyaAction;
+export declare function buildGetDeviceDpsAction(devId: string): TuyaAction;
 /**
  * LOGIN step 1: fetch a pre-login RSA token for a Tuya uid.
  * Wire-confirmed from the eufy Security app (`com.oceanwing.battery.cam`):

package/package.json

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