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

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.52",
   "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",