@mega-yfue/eufy-sdk 0.5.0-beta.86 → 0.5.0-beta.88

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

@@ -122,6 +122,11 @@ export declare function cameraPowerTier(model: string | undefined, capabilities:
  * harvest to report either.
  */
 export declare const CELL_PARAMS: readonly number[];
+/**
+ * The app's charger-state decode: `charging = value ∉ {0,2}`. The app applies this one rule both to a
+ * camera's `BATTERY_STATUS` (2111) and to a keypad's `APP_CMD_KEYPAD_BATTERY_CHARGER_STATE` (1655).
+ */
+export declare function isChargingState(v: string | number | boolean): boolean;
 /**
  * Every `battery` feature, declared once — the property schema, the evidence-gated getters, the derived
  * setters, the intent routes and the descriptions all come out of this table. Order is schema order.
@@ -159,7 +164,7 @@ export declare const BATTERY_MEMBERS: {
         readonly type: "bool";
         readonly kind: "boolean";
         readonly provenance: "apk";
-        readonly coerce: (v: string | number | boolean) => boolean;
+        readonly coerce: typeof isChargingState;
         readonly description: string;
     };
     /**

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

@@ -418,7 +418,7 @@ export interface DeviceActionMap {
     smoke: SmokeActions;
     /** CO-detector reads (read-only): `coDetected`, `lastSeen`. */
     co: CoActions;
-    /** Security-keypad reads (read-only): `rssi`. */
+    /** Security-keypad reads (read-only): `charging`, `rssi`. */
     keypad: KeypadActions;
     /** RTSP publish for a NAS/NVR: `publish`/`withdraw` + `published`, `requireAuth`/`allowAnonymous`, `recordingMode`/`setRecordingMode`. One camera at a time per station. */
     rtsp: RtspActions;

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

@@ -1,13 +1,12 @@
+import { isChargingState } from "./battery.js";
 import { type Surface } from "./members.js";
 import type { CapabilityModule } from "./types.js";
 /**
- * Every `keypad` feature, declared once. Only `rssi` is a verified read.
+ * Every `keypad` feature, declared once. `rssi` is a verified read and `charging` follows the app's own
+ * decode of the keypad's charger state.
  *
- * The battery pair is `unexposed`: both ids are placeholders, and the keypad's real battery state is
- * reported under model-specific params (`keypadBatteryCapState` / `keypadBatteryChargerState`, seen
- * live) whose low/charging semantics are not confirmed. They stay in the schema so a diagnosis can
- * reach them through `getProperty`, with no typed getter asserting a meaning this SDK cannot back.
- * A live probe of the fleet's T8960 confirms neither is reported at all today.
+ * `batteryLow` is `unexposed`: the app maps its param to the same low-battery field the entry and motion
+ * sensors feed, but its value decode is absent from the app's parser, so the polarity is not evidenced.
  *
  * Exported but NOT published: each entry states its wire id and the evidence it was confirmed on,
  * which the reference site does not carry.
@@ -15,36 +14,34 @@ import type { CapabilityModule } from "./types.js";
  */
 export declare const KEYPAD_MEMBERS: {
     /**
-     * `unexposed`, so it reaches a diagnosis through `getProperty` but gets no typed getter. 1103 is a
-     * placeholder AND a likely collision — the app's own param table names 1103 GET_CAMERA_INFO — so a
-     * getter here would be asserting a meaning nothing backs. The keypad's real battery state arrives
-     * under `keypadBatteryCapState`, whose low/charging semantics are not confirmed.
+     * `APP_CMD_KEYPAD_BATTERY_CAP_STATE` (1653). The app's sensor parser maps it to `sensor_is_low_power`,
+     * the field `APP_CMD_ENTRY_SENSOR_BAT_STATE` and `APP_CMD_MOTION_SENSOR_BAT_STATE` decode as a boolean,
+     * yet gives 1653 itself no decode case. `unexposed` until a device confirms which value means low; in
+     * the schema for `getProperty`, absent from the typed surface.
      */
     readonly batteryLow: {
-        readonly param: 1103;
+        readonly param: 1653;
         readonly type: "bool";
         readonly kind: "boolean";
-        readonly provenance: "guessed";
+        readonly provenance: "apk";
         readonly unexposed: true;
         readonly description: string;
     };
     /**
-     * The charging half of the battery pair, `unexposed` for the same reason as `batteryLow`: 1102 is a
-     * placeholder id, and the state the keypad actually reports (`keypadBatteryChargerState`) has no
-     * confirmed value space. In the schema for `getProperty`, absent from the typed surface.
+     * `APP_CMD_KEYPAD_BATTERY_CHARGER_STATE` (1655), decoded the way the app's sensor parser decodes it:
+     * `charging = value ∉ {0,2}` ({@link isChargingState}).
      */
     readonly charging: {
-        readonly param: 1102;
+        readonly param: 1655;
         readonly type: "bool";
         readonly kind: "boolean";
-        readonly provenance: "guessed";
-        readonly unexposed: true;
-        readonly description: "Keypad charging flag. UNVERIFIED: placeholder id pending verification.";
+        readonly provenance: "apk";
+        readonly coerce: typeof isChargingState;
+        readonly description: string;
     };
     /**
-     * The keypad's link quality in dBm — the one verified read in this table, on the same param 1141 the
-     * other sub-1G sensors report signal strength on. Reported as the device measures it: raw dBm, never
-     * normalised to a bar count.
+     * The keypad's link quality in dBm, on the same param 1141 the other sub-1G sensors report signal
+     * strength on. Reported as the device measures it: raw dBm, never normalised to a bar count.
      */
     readonly rssi: {
         readonly param: 1141;
@@ -57,5 +54,5 @@ export declare const KEYPAD_MEMBERS: {
 };
 /** Bound keypad reads — the object returned by `dev.keypad()`. Read-only. */
 export type KeypadActions = Surface<typeof KEYPAD_MEMBERS>;
-/** `keypad` — security keypad. Battery low/charging and signal. Param ids here are placeholders apart from RSSI. */
+/** `keypad` — security keypad. Charging, battery-low and signal. */
 export declare const KEYPAD: CapabilityModule;

package/dist/transport/push/push-client.d.ts

@@ -32,6 +32,11 @@ export declare class PushClient extends EventEmitter {
     private closing;
     /** Consecutive MCS login rejections — transient ones self-heal via reconnect (see {@link onMessage}). */
     private loginFailures;
+    /**
+     * How many of {@link persistentIds} the last `LoginRequest` reported; a successful `LoginResponse`
+     * acknowledges them, so they are dropped then.
+     */
+    private reportedIds;
     constructor(creds: FcmCredentials, logger?: Logger);
     /** Persistent ids already seen (set this from storage to avoid re-delivery). */
     setPersistentIds(ids: string[]): void;

package/package.json

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