@mega-yfue/eufy-sdk 0.4.0-beta.16 → 0.4.0-beta.18

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

@@ -164,7 +164,7 @@ export declare function parseQuickResponses(voiceList: Array<{
 }>): QuickResponse[];
 /**
  * `doorbell` — chime / ringtone configuration. CONFIRMED against a real Video Doorbell (T8214):
- * the live ids are the `1702-1719` `CMD_BAT_DOORBELL_*` range (provenance "mega", observed). The
+ * the live ids are the `1702-1719` `CMD_BAT_DOORBELL_*` range, observed on that device. The
  * legacy `2015/2022/1306` ids are excluded — they appear on NO owned device. The button-
  * press *event* (ring) is delivered out-of-band via `CMD_DOORBELL_NOTIFY_PAYLOAD` (1701) /
  * push/MQTT — it is handled by the Phase-1 event normalizers, not as a device-list param.
@@ -185,9 +185,9 @@ export declare function parseQuickResponses(voiceList: Array<{
 export declare const DOORBELL_MEMBERS: {
     /**
      * The HOMEBASE as the doorbell's chime — the hub plays the ring, not the wired chime box
-     * `mechanicalChimeSwitch` drives. `provenance` is "verified" on our own decrypt of the app's frame,
-     * not merely the param id observed live: direct-binary `[ch][value][acct]`, 1=on/0=off, the same shape
-     * as its 1703 sibling — captured, not inferred from the shared param range.
+     * `mechanicalChimeSwitch` drives. `provenance` is "verified" on our own decrypt of the app's frame:
+     * direct-binary `[ch][value][acct]`, 1=on/0=off, the same shape as its 1703 sibling — captured, not
+     * inferred from the shared param range.
      */
     readonly chimeSwitch: {
         readonly param: 1702;
@@ -198,9 +198,8 @@ export declare const DOORBELL_MEMBERS: {
         readonly write: (v: string | number | boolean, ctx: import("./types.js").CommandContext) => import("../../core/contracts.js").Command;
     };
     /**
-     * `provenance` is "verified" not "mega": the actual write wire is confirmed (
-     * our own P2P decrypt), not merely the param id observed on a live device. Direct-binary
-     * `[ch][value][acct]`, 1=on/0=off — verified live on a T8214 (ON then OFF).
+     * `provenance` is "verified" on our own P2P decrypt of the write wire: direct-binary
+     * `[ch][value][acct]`, 1=on/0=off, verified live on a T8214 (ON then OFF).
      */
     readonly mechanicalChimeSwitch: {
         readonly param: 1703;
@@ -231,7 +230,7 @@ export declare const DOORBELL_MEMBERS: {
         readonly type: "number";
         readonly unit: "%";
         readonly kind: "percent";
-        readonly provenance: "mega";
+        readonly provenance: "verified";
         readonly writtenElsewhere: true;
         readonly description: string;
     };
@@ -325,7 +324,7 @@ export declare const DOORBELL_MEMBERS: {
         readonly param: 1710;
         readonly type: "string";
         readonly kind: "text";
-        readonly provenance: "mega";
+        readonly provenance: "verified";
         readonly description: string;
     };
     /**

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

@@ -98,7 +98,6 @@ export declare const MOTION_CMD: {
      * payload key AND pass mChannel 0 explicitly; the two are separate choices, not linked.)
      *
      * ⚠️ Replay + readback confirmed on a HomeBase-attached T8425 (1719 `0`→`1`→`0`), NOT byte-captured.
-     * Provenance is `apk`, not `verified`: a divergent-but-also-accepted frame can't be ruled out.
      */
     readonly HUMAN_ONLY_AT_NIGHT: 1719;
     /**
@@ -112,7 +111,7 @@ export declare const MOTION_CMD: {
      * form, so a feature that is on reads as off.
      * Decoded by {@link decodeRadarWdSwitch} to match the app.
      *
-     * ⚠️ Replay + readback confirmed on a T8214 (2706 `0`→`1`→`0`), NOT byte-captured. Provenance `apk`.
+     * ⚠️ Replay + readback confirmed on a T8214 (2706 `0`→`1`→`0`), NOT byte-captured.
      */
     readonly LOITERING_DETECTION: 2706;
     /**
@@ -354,7 +353,7 @@ export declare const MOTION_MEMBERS: {
         readonly param: 1719;
         readonly type: "bool";
         readonly kind: "boolean";
-        readonly provenance: "apk";
+        readonly provenance: "verified";
         readonly description: string;
         readonly requires: readonly [1719];
         readonly write: (v: string | number | boolean, ctx: CommandContext) => Command;
@@ -367,7 +366,7 @@ export declare const MOTION_MEMBERS: {
         readonly param: 2706;
         readonly type: "bool";
         readonly kind: "boolean";
-        readonly provenance: "apk";
+        readonly provenance: "verified";
         readonly coerce: (raw: string | number | boolean) => boolean;
         readonly description: string;
         readonly requires: readonly [2706];

package/dist/model/param-dictionary.d.ts

@@ -5,10 +5,10 @@
  * Two namespaces (params are per-transport, NOT globally unique):
  *  - SECURITY_PARAMS — eufy P2P param space (ids 1000+). **Membership is the observation**: an id is
  *    listed only because the sweep saw it on a real owned device, so the id is real/accepted.
- *    `provenance` is the trust of the NAME/meaning: "verified" (our captures) > "apk" (the app's own
- *    decompiled constant name) > "guessed" (no name source — needs toggle-diff).
+ *    `provenance` is the trust of the NAME/meaning; the tiers are defined on `PropertySource` in
+ *    `types.ts`.
  *  - CLEAN_PARAMS — RoboVac Tuya DP space (ids 1 and above), names from the cloud
- *    `get_product_data_point` data_point_list (provenance "mega" — authoritative).
+ *    `get_product_data_point` data_point_list, hence provenance `mega`.
  *
  * Which models reported an id, and the capture that named it, are in the commit that adds the entry.
  */

package/dist/model/types.d.ts

@@ -104,18 +104,17 @@ export type ValueKind = KnownValueKind | (string & {});
  */
 export declare function isKnownValueKind(kind: ValueKind): kind is KnownValueKind;
 /**
- * Trust provenance of a property's `param_type` mapping, most-trusted first:
- *  - `mega`     — confirmed against the live mega API / a real device's reported params.
- *  - `apk`      — extracted from the v6 app itself (the ids the app actually sends — authoritative).
- *  - `verified` — confirmed by our own capture/observation.
- *  - `guessed`  — a plausible placeholder; lowest trust.
+ * How much a param's name and meaning can be trusted, most-trusted first. This is the one definition;
+ * the param dictionary and every `provenance` field use it.
+ *  - `mega`     — the vendor's cloud names it: its data-point catalog (`get_product_data_point`), or a
+ *                 reported value that matches what the cloud record already says (a model name or code).
+ *  - `verified` — confirmed on a real device by this project: our own capture or observation, or
+ *                 identified by someone who has the hardware.
+ *  - `apk`      — the v6 app's own decompiled constant name, not yet confirmed on a device.
+ *  - `guessed`  — no name source; a plausible placeholder until a toggle-diff settles it.
  *
- * This project never relies on a third-party reverse-engineering project as a source of trust —
- * every id/behavior we ship is grounded in the app's
- * own decompiled code (`apk`) or our own capture/observation (`verified`), never someone else's
- * unverified guess. Absent provenance is treated as `guessed`.
- *
- * Provenance of a property definition — an internal trust label used when curating the model.
+ * A third-party reverse-engineering project is never a source: every name we ship comes from the
+ * vendor's cloud, our own observation or the app itself. Absent provenance is treated as `guessed`.
  * @internal
  */
 export type PropertySource = "mega" | "apk" | "verified" | "guessed";

package/dist/transport/p2p/p2p-session.d.ts

@@ -566,6 +566,10 @@ export declare class P2PSession extends EventEmitter {
      * The HomeBase streams back `CMD_DATABASE` (1306) frames `{cmd:10000,count,data:[…]}`,
      * level-1-encrypted — decoded and emitted as `dbChunk` (decrypted text) per frame.
      * Tables: `familiar_faces`, `person_basic_info`, `event_person_list`, `history_record_info`.
+     *
+     * Throws while a {@link readDatabase} is accumulating: every table answers `{data:[…]}` and the
+     * frames tie no chunk to its request, so a second query's reply would be assembled into the first
+     * one's buffer and answered as its rows.
      */
     queryDatabase(table: string, opts?: {
         accountId?: string;
@@ -593,6 +597,25 @@ export declare class P2PSession extends EventEmitter {
         accountId?: string;
         channel?: number;
     }): void;
+    /**
+     * Query one on-station table and answer its rows, once the reply is whole.
+     *
+     * The request half of {@link queryDatabase} with its reply assembled: `CMD_DATABASE` arrives as
+     * several frames whose decrypted text is a fragment of one document, so the fragments are
+     * accumulated here and scanned after each one. Answers that document's `data` rows. Rejects when
+     * `signal` aborts, and when `timeoutMs` (default {@link DB_TABLE_TIMEOUT_MS}) elapses with no
+     * complete reply.
+     *
+     * One read at a time per session: while one is accumulating, every {@link queryDatabase} on the
+     * session throws, so a second reply cannot land in this buffer.
+     */
+    readDatabase(table: string, opts?: {
+        accountId?: string;
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<unknown[]>;
+    /** Whether a {@link readDatabase} is accumulating; see {@link queryDatabase} for what it bars. */
+    private dbReadInFlight;
     /**
      * Request the **face feature rows** over P2P (`face_feature_info`, inner `cmd 10000`). Each row
      * carries `{person_id, face_name, face_id, face_picture_content, face_feature_file_path}` — where

package/package.json

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