@mega-yfue/eufy-sdk 0.6.0-beta.44 → 0.6.0-beta.46

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

@@ -21,18 +21,6 @@ export declare const CO_MEMBERS: {
         readonly provenance: "guessed";
         readonly description: "Carbon-monoxide detected. UNVERIFIED: placeholder id pending capture verification.";
     };
-    /**
-     * Unix seconds at which the detector last checked in — param 1551, the same last-seen id the other
-     * sensor capabilities read. A `timestamp` kind takes no `unit`: the number is an instant, not a
-     * duration, and declaring `unit: "s"` beside it fails the value-kind spec.
-     */
-    readonly lastSeen: {
-        readonly param: 1551;
-        readonly type: "number";
-        readonly kind: "timestamp";
-        readonly provenance: "verified";
-        readonly description: "Last-seen unix timestamp, seconds (verified: param 1551).";
-    };
 };
 /** Bound CO-detector reads — the object returned by `dev.co()`. Read-only. */
 export type CoActions = Surface<typeof CO_MEMBERS>;

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

@@ -34,8 +34,7 @@ export type EntryAlarmToneValue = (typeof EntryAlarmTone)[keyof typeof EntryAlar
  */
 export type ContactActions = Surface<typeof CONTACT_MEMBERS>;
 /**
- * Every `contact` feature, declared once. `contact` (1550) and `lastSeen` (1551) are verified reads;
- * the built-in alarm tone (1507) and volume (1508) are verified writes captured live on a T90E0.
+ * Every `contact` feature, declared once. `contact` (1550) is a verified read; the built-in alarm tone (1507) and volume (1508) are verified writes captured live on a T90E0.
  *
  * Exported but NOT published: each entry states its wire id and the evidence it was confirmed on,
  * which the reference site does not carry.
@@ -57,31 +56,6 @@ export declare const CONTACT_MEMBERS: {
         readonly provenance: "verified";
         readonly description: "Contact state, true=open (verified: param 1550 entry-sensor contact).";
     };
-    /**
-     * Unix seconds at which the sensor last checked in — the liveness read beside the contact state, and
-     * the way to tell a genuinely closed door from a sensor that stopped reporting. A `timestamp` kind
-     * takes no `unit`: it is an instant, not a duration.
-     */
-    readonly lastSeen: {
-        readonly param: 1551;
-        readonly type: "number";
-        readonly kind: "timestamp";
-        readonly provenance: "verified";
-        readonly description: "Last-seen unix timestamp, seconds (verified: param 1551).";
-    };
-    /**
-     * Link quality to whichever radio the sensor is paired over, in dBm as the device measures it. The
-     * same param 1141 the other sub-1G sensors report on, so the number is comparable across them —
-     * unlike a bars mapping, which this SDK never applies.
-     */
-    readonly rssi: {
-        readonly param: 1141;
-        readonly type: "number";
-        readonly unit: "dBm";
-        readonly kind: "dbm";
-        readonly provenance: "verified";
-        readonly description: "Sub-1G/Wi-Fi signal strength (verified: param 1141 = RSSI).";
-    };
     /**
      * Rejected, not clamped, outside the tone enum: a fire-and-forget write of a bogus tone would look like
      * it worked. The wire is a direct-binary scalar `[ch][value][acct]` at signCode 8 — the app's own
@@ -131,7 +105,6 @@ export declare const CONTACT_MEMBERS: {
     };
 };
 /**
- * `contact` — entry/door-window sensor. `contact` (1550) and `lastSeen` (1551) are verified; the
- * built-in alarm tone (1507) and volume (1508) are verified writes captured live on a T90E0.
+ * `contact` — entry/door-window sensor. `contact` (1550) is verified; the built-in alarm tone (1507) and volume (1508) are verified writes captured live on a T90E0.
  */
 export declare const CONTACT: CapabilityModule;

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

@@ -37,6 +37,7 @@ import type { ContactActions } from "./contact.js";
 import type { LeakActions } from "./leak.js";
 import type { SmokeActions } from "./smoke.js";
 import type { CoActions } from "./co.js";
+import type { LinkActions } from "./link.js";
 import type { KeypadActions } from "./keypad.js";
 import type { RtspActions } from "./rtsp.js";
 import type { VacuumCleanActions } from "./vacuum-clean.js";
@@ -411,16 +412,18 @@ export interface DeviceActionMap {
     doorbell: DoorbellActions;
     /** Motion/PIR: `setDetection(on)` (sensitivity is read-only until its write wire is captured). */
     motion: MotionActions;
-    /** Entry (door/window) sensor: reads `open`, `lastSeen`, `rssi`, `alarmSoundType`, `alarmVolume`; writes `setAlarmSoundType`, `setAlarmVolume` (present when the sensor reports the alarm params). */
+    /** Entry (door/window) sensor: reads `open`, `alarmSoundType`, `alarmVolume`; writes `setAlarmSoundType`, `setAlarmVolume` (present when the sensor reports the alarm params). */
     contact: ContactActions;
-    /** Water-leak / freeze sensor reads (read-only): `leakDetected`, `lastSeen`. */
+    /** Water-leak / freeze sensor reads (read-only): `leakDetected`. */
     leak: LeakActions;
-    /** Smoke-detector reads (read-only): `smokeDetected`, `lastSeen`. */
+    /** Smoke-detector reads (read-only): `smokeDetected`. */
     smoke: SmokeActions;
-    /** CO-detector reads (read-only): `coDetected`, `lastSeen`. */
+    /** CO-detector reads (read-only): `coDetected`. */
     co: CoActions;
-    /** Security-keypad reads (read-only): `charging`, `rssi`. */
+    /** Security-keypad reads (read-only): `charging`. */
     keypad: KeypadActions;
+    /** Check-in and signal reads (read-only): `lastSeen`, `rssi`, each where the device reports it. */
+    link: LinkActions;
     /** RTSP publish for a NAS/NVR: `publish`/`withdraw` + `published`, `requireAuth`/`allowAnonymous`, `recordingMode`/`setRecordingMode`. One camera at a time per station. */
     rtsp: RtspActions;
     /** RoboVac core state and controls: `power`, `activity` (WorkStatus), `volume`, `battery`, `cleanType`; `setPower`, `startCleaning`, `returnToDock`, `pauseCleaning`. */
@@ -528,7 +531,7 @@ export type { ActionSpec } from "./types.js";
  * `undefined` for an action nothing describes.
  */
 export { actionSpecOf } from "./access.js";
-export type { PtzActions, LightActions, SmartLightActions, RgbColor, CameraActions, LockActions, SirenActions, ArmingActions, BatteryActions, MotionActions, ContactActions, LeakActions, SmokeActions, CoActions, KeypadActions, RtspActions, VacuumCleanActions, SuctionActions, MowerActions, LocateActions, SmartDropActions, };
+export type { PtzActions, LightActions, SmartLightActions, RgbColor, CameraActions, LockActions, SirenActions, ArmingActions, BatteryActions, MotionActions, ContactActions, LeakActions, SmokeActions, CoActions, KeypadActions, LinkActions, RtspActions, VacuumCleanActions, SuctionActions, MowerActions, LocateActions, SmartDropActions, };
 /**
  * The member table each `*Actions` type is DERIVED from (`LockActions = Surface<typeof LOCK_MEMBERS>`),
  * so the type names the table and the table is part of the published surface.
@@ -545,6 +548,7 @@ export { CO_MEMBERS } from "./co.js";
 export { CONTACT_MEMBERS } from "./contact.js";
 export { DOORBELL_MEMBERS } from "./doorbell.js";
 export { KEYPAD_MEMBERS } from "./keypad.js";
+export { LINK_MEMBERS } from "./link.js";
 export { LEAK_MEMBERS } from "./leak.js";
 export { LIGHT_MEMBERS } from "./light.js";
 export { LOCATE_MEMBERS } from "./locate.js";

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

@@ -2,8 +2,8 @@ import { isChargingState } from "./battery.js";
 import { type Surface } from "./members.js";
 import type { CapabilityModule } from "./types.js";
 /**
- * Every `keypad` feature, declared once. `rssi` is a verified read and `charging` follows the app's own
- * decode of the keypad's charger state.
+ * Every `keypad` feature, declared once. `charging` follows the app's own decode of the keypad's charger
+ * state.
  *
  * `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.
@@ -39,18 +39,6 @@ export declare const KEYPAD_MEMBERS: {
         readonly coerce: typeof isChargingState;
         readonly description: string;
     };
-    /**
-     * 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;
-        readonly type: "number";
-        readonly unit: "dBm";
-        readonly kind: "dbm";
-        readonly provenance: "verified";
-        readonly description: "Keypad signal strength (verified: param 1141 = RSSI).";
-    };
 };
 /** Bound keypad reads — the object returned by `dev.keypad()`. Read-only. */
 export type KeypadActions = Surface<typeof KEYPAD_MEMBERS>;

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

@@ -21,18 +21,6 @@ export declare const LEAK_MEMBERS: {
         readonly provenance: "guessed";
         readonly description: string;
     };
-    /**
-     * Unix seconds at which the sensor last checked in — param 1551, the same last-seen id the other
-     * sensor capabilities read. A `timestamp` kind takes no `unit`: the number is an instant, not a
-     * duration, and declaring `unit: "s"` beside it fails the value-kind spec.
-     */
-    readonly lastSeen: {
-        readonly param: 1551;
-        readonly type: "number";
-        readonly kind: "timestamp";
-        readonly provenance: "verified";
-        readonly description: "Last-seen unix timestamp, seconds (verified: param 1551).";
-    };
 };
 /** Bound leak-sensor reads — the object returned by `dev.leak()`. Read-only. */
 export type LeakActions = Surface<typeof LEAK_MEMBERS>;

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

@@ -0,0 +1,39 @@
+import { type Surface } from "./members.js";
+import type { CapabilityModule } from "./types.js";
+/**
+ * Every `link` feature, declared once: the check-in and signal params a security device reports
+ * whatever it is (sensor, keypad, lock), each getter present only where the device reports its param.
+ * A capability with a reason to declare one of these properties itself takes precedence, since the
+ * first declaration of a property wins and `link` is registered after every device capability.
+ *
+ * Exported but NOT published: each entry states its wire id and the evidence it was confirmed on,
+ * which the reference site does not carry.
+ * @internal
+ */
+export declare const LINK_MEMBERS: {
+    /**
+     * Unix seconds at which the device last checked in, as the device itself reports it — beside
+     * `deviceState(sn).lastSeenMs`, which the SDK derives from the cloud's own update times. A
+     * `timestamp` takes no `unit`: it is an instant, not a duration.
+     */
+    readonly lastSeen: {
+        readonly param: 1551;
+        readonly type: "number";
+        readonly kind: "timestamp";
+        readonly provenance: "verified";
+        readonly description: "Last-seen unix timestamp, seconds (verified: param 1551).";
+    };
+    /** Link quality in dBm as the device measures it, never normalised to a bar count. */
+    readonly rssi: {
+        readonly param: 1141;
+        readonly type: "number";
+        readonly unit: "dBm";
+        readonly kind: "dbm";
+        readonly provenance: "verified";
+        readonly description: "Sub-1G/Wi-Fi signal strength (verified: param 1141 = RSSI).";
+    };
+};
+/** Bound check-in and signal reads — the object returned by `dev.link()`. Read-only. */
+export type LinkActions = Surface<typeof LINK_MEMBERS>;
+/** `link` — the check-in timestamp and signal strength a security device reports. */
+export declare const LINK: CapabilityModule;

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

@@ -101,18 +101,6 @@ export declare const LOCK_MEMBERS: {
         readonly provenance: "verified";
         readonly description: "Lock battery level 0-100 (verified: param 1101, alias 6001).";
     };
-    /**
-     * Link quality in dBm as the lock measures it, on the shared param 1141. On the `ff09` wire the
-     * actuations are fire-and-forget, so a weak link is silent rather than an error.
-     */
-    readonly rssi: {
-        readonly param: 1141;
-        readonly type: "number";
-        readonly unit: "dBm";
-        readonly kind: "dbm";
-        readonly provenance: "verified";
-        readonly description: "Lock signal strength (verified: param 1141 = RSSI).";
-    };
     /**
      * Lock the deadbolt/door. Resolves after sending, without confirming physical state — except on the
      * classic Wi-Fi lock, which answers: there it rejects on a device refusal or no reply as well.

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

@@ -21,18 +21,6 @@ export declare const SMOKE_MEMBERS: {
         readonly provenance: "guessed";
         readonly description: "Smoke detected. UNVERIFIED: placeholder id pending capture verification.";
     };
-    /**
-     * Unix seconds at which the detector last checked in — param 1551, the same last-seen id the other
-     * sensor capabilities read. A `timestamp` kind takes no `unit`: the number is an instant, not a
-     * duration, and declaring `unit: "s"` beside it fails the value-kind spec.
-     */
-    readonly lastSeen: {
-        readonly param: 1551;
-        readonly type: "number";
-        readonly kind: "timestamp";
-        readonly provenance: "verified";
-        readonly description: "Last-seen unix timestamp, seconds (verified: param 1551).";
-    };
 };
 /** Bound smoke-detector reads — the object returned by `dev.smoke()`. Read-only. */
 export type SmokeActions = Surface<typeof SMOKE_MEMBERS>;

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

@@ -178,6 +178,12 @@ export interface EventClaim {
      * and ignored where that is absent.
      */
     homeBaseAttached?: boolean;
+    /**
+     * Thing-description property identifiers whose presence is the evidence: the product's description,
+     * resolved for this device, lists at least one of them. Compared against
+     * {@link AvailabilityContext.things}, and ignored where that is absent.
+     */
+    things?: readonly string[];
 }
 /**
  * A decoded inbound event a capability wants surfaced on the SDK. `event` is the EufyMega event

package/dist/model/device.d.ts

@@ -86,6 +86,8 @@ export declare class Device {
      * answers a caller has to be able to tell apart.
      */
     private bound;
+    /** The product's thing description resolved for this device, as {@link bindActions} was given it. */
+    private things?;
     /**
      * Read-through freshness policy (injected by the facade via {@link setFreshnessPolicy}; the model
      * stays transport-free — it only calls the supplied `refresh`). Default: caching OFF

package/dist/model/types.d.ts

@@ -40,7 +40,7 @@ export type Codec = "station" | "camera" | "sensor" | "lock" | "keypad" | "vacuu
  * it maps to a {@link CapabilityModule} that owns its property schema. Extend this union as
  * new capabilities are modelled — adding one never requires a subclass.
  */
-export type Capability = "video" | "snapshot" | "motion" | "person_detection" | "battery" | "light" | "ptz" | "doorbell" | "contact" | "leak" | "smoke" | "co" | "siren" | "lock" | "keypad" | "arming" | "storage" | "rtsp" | "camera" | "audio" | "vacuum_clean" | "vacuum_dock" | "suction" | "locate" | "mower" | "smart_drop" | "smart_light" | "display" | "info";
+export type Capability = "video" | "snapshot" | "motion" | "person_detection" | "battery" | "light" | "ptz" | "doorbell" | "contact" | "leak" | "smoke" | "co" | "siren" | "lock" | "keypad" | "link" | "arming" | "storage" | "rtsp" | "camera" | "audio" | "vacuum_clean" | "vacuum_dock" | "suction" | "locate" | "mower" | "smart_drop" | "smart_light" | "display" | "info";
 /** Value type of a property. */
 export type PropertyValueType = "bool" | "number" | "string" | "enum";
 /**

package/package.json

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