@mega-yfue/eufy-sdk 0.6.0-beta.41 → 0.6.0-beta.42

package/dist/client/device-registry.d.ts

@@ -11,6 +11,13 @@ import { MegaHttpClient } from "../transport/http/mega-client.js";
 import { type Logger } from "../core/logger.js";
 import { type EufyDevice } from "../core/types.js";
 import { type Capability, type DeviceInspection } from "../model/index.js";
+import { type ThingDescription } from "../model/capabilities/thing-description.js";
+/**
+ * Read a non-empty string field off a raw device record, tolerating the app's `deviceParams` nesting
+ * (the v6 app resolves e.g. firmware as `record.deviceParams?.main_sw_version ?? record.main_sw_version`).
+ * Returns `undefined` for a missing or empty value, so a blank firmware never surfaces as `""`.
+ */
+export declare function recordString(raw: Record<string, unknown>, key: string): string | undefined;
 /** The device-record shape {@link EufyMega.getDevice}/`commandContext` resolve a serial to. */
 export interface DeviceRecord {
     deviceType?: number;
@@ -35,6 +42,8 @@ export interface DeviceRecord {
      * capabilities a device is judged to have.
      */
     dpParams?: Record<number, string>;
+    /** The product's thing description (see {@link CloudRecord.things}). */
+    things?: ThingDescription;
 }
 /**
  * One param that changed value between two polls — the input the facade turns into a
@@ -97,6 +106,8 @@ export declare class DeviceRegistry {
     private readonly deviceCapsCache;
     /** Per-serial cloud data points of an AIoT robot, joined beneath the params in {@link record} — see {@link loadCloudDps}. */
     private readonly cloudDps;
+    /** Per-product-code thing description — see {@link loadThings}; `undefined` for a code the cloud returned none for. */
+    private readonly things;
     /** Per-serial realtime state, keyed by param id in the device's own namespace (see {@link DeviceRecord.dpParams}). */
     private readonly dpParams;
     /** Callers blocked in {@link awaitRealtimeState}, released by the device's first report. */
@@ -202,6 +213,17 @@ export declare class DeviceRegistry {
      * DP numbers their realtime reports use.
      */
     private loadCloudDps;
+    /**
+     * The device's product description resolved for this device ({@link resolveThing}): against its serial
+     * and firmware (`main_sw_version`), the station it is reached through and that station's firmware, the
+     * account's country and its reported params.
+     */
+    private thingsFor;
+    /**
+     * Fetch, once per start, the thing description of each product code the account has, in one
+     * `get_things_list` call. A failed call is logged and asked again on the next refresh.
+     */
+    private loadThings;
     /**
      * Resolve a serial to a {@link DeviceRecord} with current params: starts from the device-list params, then
      * overlays a fresh `get_device_param_list` when that call is available to this account. An AIoT robot's