@mega-yfue/eufy-sdk 0.2.0-beta.26 → 0.2.0-beta.27

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

@@ -14,8 +14,9 @@ export declare const DOORBELL_CMD: {
      */
     readonly QUICK_RESPONSE: 1706;
     /**
-     * Mechanical (wired) chime enable/disable — whether the doorbell drives an existing wired chime box
-     * (as opposed to / in addition to the wireless indoor chime, param 1702 `chimeSwitch` above). Same
+     * Mechanical (wired) chime enable/disable — whether the doorbell drives an existing wired chime box,
+     * the app's "existing doorbell chime" (as opposed to / in addition to the HomeBase acting as the chime,
+     * param 1702 `chimeSwitch` above; toggling each switch alone wrote one parameter and named the pair). Same
      * 136-byte direct-binary shape as `QUICK_RESPONSE`/camera on-off: `[u32 channel][u32 value][account_id
      * ASCII, zero-padded to 128 bytes]`, outer P2P cmd = 1703 itself, signCode 8, on the device's own
      * channel. Reversed from a live capture (outer-cmd 1703, signCode 8, captured on the doorbell's
@@ -24,6 +25,19 @@ export declare const DOORBELL_CMD: {
      * App `APP_CMD_BAT_DOORBELL_MECHANICAL_CHIME_SWITCH`.
      */
     readonly MECHANICAL_CHIME_SWITCH: 1703;
+    /**
+     * Whether the HOMEBASE acts as the doorbell's chime — the app's "HomeBase as chime" switch, as opposed
+     * to the wired chime box {@link DOORBELL_CMD.MECHANICAL_CHIME_SWITCH} drives. The app constant reads
+     * `CHIME_SWITCH`, which is why this was long described as a separate plug-in chime; toggling that one
+     * switch alone on a T8210 behind a HomeBase wrote 1702 and nothing else, and the account has no
+     * plug-in chime at all. Same 136-byte direct-binary shape as
+     * that sibling: `[u32 channel][u32 value][account_id ASCII, zero-padded to 128 bytes]`, outer P2P cmd
+     * 1702 itself, signCode 8, on the device's own channel. Reversed from a live capture (outer-cmd 1702,
+     * signCode 8, on the doorbell's `device_channel` — 2 for that unit, NOT a wire constant, always use
+     * `ctx.channel`): turning OFF sent `value=0`, turning ON sent `value=1` — a plain boolean.
+     * App `APP_CMD_BAT_DOORBELL_CHIME_SWITCH`.
+     */
+    readonly CHIME_SWITCH: 1702;
     /**
      * Wide Dynamic Range (WDR) image switch — a video/image tone-mapping setting that widens the
      * exposure range in high-contrast scenes (bright sky behind a visitor, etc). SAME 136-byte
@@ -158,13 +172,10 @@ export declare function parseQuickResponses(voiceList: Array<{
 /**
  * Every `doorbell` feature, declared once.
  *
- * Three of the seven reads are read-ONLY here even though the device accepts a write, because the write
+ * Two of the seven reads are read-ONLY here even though the device accepts a write, because the write
  * does not belong to this capability or is not confirmed:
  *  - `ringtoneVolume` (1708) — the WRITE lives on `audio`, which owns every volume wire. 1708 leaks
  *    onto non-doorbell cameras, so `audio` gates its setter on the doorbell capability instead.
- *  - `chimeSwitch` (1702) — READ confirmed on a T8214, the WRITE wire never captured. Its 1703/1704
- *    siblings share the param range but that is NOT evidence of a shared frame, and a wrong guess on a
- *    fire-and-forget P2P write looks exactly like success.
  *  - `notificationMode` (1710) — a config JSON the device reports whole; no write is captured.
  *
  * Exported but NOT published: each entry states its wire id and the evidence it was confirmed on,
@@ -173,19 +184,18 @@ export declare function parseQuickResponses(voiceList: Array<{
  */
 export declare const DOORBELL_MEMBERS: {
     /**
-     * The WIRELESS indoor chime — the separate plug-in unit, not the wired chime box
-     * `mechanicalChimeSwitch` drives. `unverified: true` with no `write` at all: the read is confirmed but
-     * the write frame has never been captured, so the setter is absent from the surface (a compile-time
-     * signal) and the intent path throws rather than reporting the doorbell as lacking the feature.
-     * Sharing the 1702-1719 range with its captured siblings is not evidence of a shared frame shape.
+     * 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.
      */
     readonly chimeSwitch: {
         readonly param: 1702;
         readonly type: "bool";
         readonly kind: "boolean";
-        readonly provenance: "mega";
-        readonly unverified: true;
+        readonly provenance: "verified";
         readonly description: string;
+        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 (
@@ -197,7 +207,7 @@ export declare const DOORBELL_MEMBERS: {
         readonly type: "bool";
         readonly kind: "boolean";
         readonly provenance: "verified";
-        readonly description: "Mechanical chime enabled (1703; confirmed on T8214).";
+        readonly description: string;
         readonly write: (v: string | number | boolean, ctx: import("./types.js").CommandContext) => import("../../core/contracts.js").Command;
     };
     /** Same reasoning and the same capture session as {@link DOORBELL_MEMBERS.mechanicalChimeSwitch}. */

package/package.json

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