@mega-yfue/eufy-sdk 0.5.0-beta.8 → 0.5.0-beta.80

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

@@ -76,10 +76,13 @@ export declare const ARMING_CMD: {
      * The ENCRYPTION LEVEL is the session's to pick (`"auto"`), not this command's: the T8030 the envelope
      * was captured on holds a level-2 key and seals it level-2, while an own-session camera that never
      * negotiates one carries the same envelope level-1. See `armingCommand`.
+     *
+     * A T8410C takes the mode as a direct frame instead of this envelope; see {@link DIRECT_ARMING_MODELS}.
      */
     readonly SET_ARMING: 1224;
     /**
-     * The per-mode alarm/arm-delay configuration write. ✅ WIRE CAPTURED live on a T8030 (
+     * One guard mode's per-device action table (app `CMD_SET_ALL_ACTION`), which carries the alarm delays
+     * and each device's actions in that mode. ✅ WIRE CAPTURED live on a T8030 (
      * 2026-07-23, both directions): a **bare
      * JSON frame, no `1350`/`1700` envelope** — outer P2P cmd IS `1255` itself, station channel 255,
      * plaintext `{account_id, count_down_alarm:{channel_list,delay_time},
@@ -96,15 +99,26 @@ export declare const ARMING_CMD: {
      * corresponding GET command (`1310`/inner cmd `40003`, sent by the app right before editing) always
      * replied `{count:0,data:null}` in every capture — genuinely empty, not a decrypt failure (confirmed
      * via the same bidirectional decrypt this finding used) — so the app does NOT read the current
-     * config this way; how it does is still unknown. Without a working GET, safely PATCHING just one
-     * channel in or out of an existing list isn't possible without risking clobbering the rest — so
+     * config this way; a T8010 reports it on its own params instead, see below. Without a working GET,
+     * safely PATCHING just one channel in or out of an existing list isn't possible without risking
+     * clobbering the rest — so
      * this ships as a caller-supplies-everything write instead of guessing a merge.
      * `devices`/`siren_sensor_action` are even less understood (raw per-device action codes, meaning
      * unconfirmed) and MUST come from a value independently read/captured for the target mode —
      * see `AlarmDelayConfig`'s field docs.
+     *
+     * ✅ On a T8010 the app writes the same command for the Device Control screen: header channel 0, the
+     * whole table of the mode `{mode_id, devices, count_down_alarm, count_down_arm}`, acked by an all-zero
+     * 1255 reply. The T8010 reports each table on its own params, Home on 1157 and Away on 1158, and the
+     * reported table follows a write within 15 s. See {@link DEVICE_NOTIFY_FLAG}.
      */
-    readonly ALARM_DELAY_CONFIG: 1255;
+    readonly SET_ALL_ACTION: 1255;
 };
+/**
+ * The guard modes whose device notification is read and written. Home and away are replayed on a T8010;
+ * `custom1` (wire 3) is captured on a T8170, whose own params report it on 1148.
+ */
+export type DeviceNotificationMode = Extract<ArmingMode, "home" | "away" | "custom1">;
 /**
  * Alarm-delay durations the app's OWN picker UI offers — `AlarmDelaySeconds` is both the const
  * value-object (`AlarmDelaySeconds.sec45`) and the union type of its values, so callers pass the
@@ -225,6 +239,27 @@ export declare const ARMING_MEMBERS: {
      * would be the same unverified guess `setMode` refuses.
      */
     readonly setAlarmDelayConfig: import("./members.js").MethodMember<(mode: AlarmDelayMode, config: AlarmDelayConfig) => Promise<void>>;
+    /**
+     * Whether the device on `channel` sends a push notification in `mode`: its {@link DEVICE_NOTIFY_FLAG}
+     * in the action table the station reports for that mode. `undefined` where the station reports no table
+     * or the table does not list `channel`. A standalone camera answers from its own 1225/1239/1148 flags,
+     * for its own channel only. A device's channel is `EufyDevice.channel`.
+     */
+    readonly deviceNotification: import("./members.js").MethodMember<(mode: DeviceNotificationMode, channel: number) => boolean | undefined> & {
+        available: (ctx: CommandContext) => boolean;
+    };
+    /**
+     * Turn the push notification of the device on `channel` on or off in `mode` (cmd
+     * {@link ARMING_CMD.SET_ALL_ACTION}): the station's reported table written back with that one flag
+     * changed. A standalone camera is sent a one-entry `{mode_id, devices}` table built from its own flags,
+     * for its own channel only. Rejects, sending nothing, where the table does not list `channel`. A write
+     * builds on the last one sent for that mode until the device reports a table (`${mode}Action` on a
+     * standalone camera) observed 15 s after it, so a second write does not revert it; a write whose dispatch
+     * rejects is not built on.
+     */
+    readonly setDeviceNotification: import("./members.js").MethodMember<(mode: DeviceNotificationMode, channel: number, on: boolean) => Promise<void>> & {
+        available: (ctx: CommandContext) => boolean;
+    };
 };
 /**
  * `arming` — guard/arming mode. `armingMode` (see {@link ARMING_CMD.SET_ARMING}) has a verified read/write

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

@@ -1,3 +1,4 @@
+import { isCameraCodec } from "./access.js";
 import { type Surface } from "./members.js";
 import type { AvailabilityContext, CapabilityModule, CommandContext } from "./types.js";
 import { type Command, type MediaProvider } from "../../core/contracts.js";
@@ -8,6 +9,8 @@ import { type Command, type MediaProvider } from "../../core/contracts.js";
  * `transport/p2p/commands.ts`). Each entry notes its app `CommandType` name.
  */
 export declare const CAMERA_CMD: {
+    /** Camera-reported Wi-Fi signal (app `CMD_GET_WIFI_RSSI`). */
+    readonly WIFI_RSSI: 1142;
     /** Camera on/off. Read and write polarity depend on the family and topology. */
     readonly CAMERA_ENABLE: 1035;
     /** Wrapped T8410 power switch on HomeBase 3. */
@@ -271,6 +274,14 @@ export type CameraActions = Surface<typeof CAMERA_MEMBERS> & {
  * @internal
  */
 export declare const CAMERA_MEMBERS: {
+    /** Reads the latest cached report and exposes no setter. */
+    readonly wifiRssi: {
+        readonly param: 1142;
+        readonly type: "number";
+        readonly kind: "scalar";
+        readonly provenance: "apk";
+        readonly description: "Camera-reported Wi-Fi signal; physical units and a quality scale are unspecified.";
+    };
     /**
      * The default READ is the *disable*-bit convention (1035 "0" ⇒ ON, 2001 direct); the WRITE polarity is
      * family-dependent — see `powerValue` / `isEnableBitPolarity`. Battery/solo cams report the state under
@@ -290,6 +301,7 @@ export declare const CAMERA_MEMBERS: {
         readonly type: "bool";
         readonly kind: "boolean";
         readonly provenance: "verified";
+        readonly available: typeof isCameraCodec;
         readonly invert: true;
         readonly invertFor: (ctx: AvailabilityContext) => false | undefined;
         readonly readAliases: readonly [{
@@ -324,6 +336,7 @@ export declare const CAMERA_MEMBERS: {
         readonly type: "bool";
         readonly kind: "boolean";
         readonly provenance: "apk";
+        readonly available: typeof isCameraCodec;
         readonly description: string;
         readonly write: (v: string | number | boolean, ctx: CommandContext) => Command;
     };
@@ -343,6 +356,7 @@ export declare const CAMERA_MEMBERS: {
             readonly 2: "Timestamp + Logo";
         };
         readonly provenance: "verified";
+        readonly available: typeof isCameraCodec;
         readonly description: string;
         readonly write: (v: string | number | boolean, ctx: CommandContext) => Command | undefined;
     };
@@ -356,6 +370,7 @@ export declare const CAMERA_MEMBERS: {
         readonly type: "bool";
         readonly kind: "boolean";
         readonly provenance: "verified";
+        readonly available: typeof isCameraCodec;
         readonly description: string;
         readonly write: (v: string | number | boolean, ctx: CommandContext) => Command;
     };
@@ -371,6 +386,7 @@ export declare const CAMERA_MEMBERS: {
         readonly type: "number";
         readonly kind: "scalar";
         readonly provenance: "verified";
+        readonly available: typeof isCameraCodec;
         readonly description: string;
         readonly write: (v: string | number | boolean, ctx: CommandContext) => Command | undefined;
     };
@@ -388,6 +404,7 @@ export declare const CAMERA_MEMBERS: {
             readonly 2: "All Sound";
         };
         readonly provenance: "verified";
+        readonly available: typeof isCameraCodec;
         readonly description: string;
         readonly write: (v: string | number | boolean, ctx: CommandContext) => Command | undefined;
     };
@@ -409,6 +426,7 @@ export declare const CAMERA_MEMBERS: {
             readonly 3: "Text First, Then Thumbnail";
         };
         readonly provenance: "verified";
+        readonly available: typeof isCameraCodec;
         readonly description: string;
         readonly write: (v: string | number | boolean, ctx: CommandContext) => Command | undefined;
     };
@@ -428,6 +446,7 @@ export declare const CAMERA_MEMBERS: {
             readonly 2: "Full Color";
         };
         readonly provenance: "verified";
+        readonly available: typeof isCameraCodec;
         readonly description: string;
         readonly write: (v: string | number | boolean, ctx: CommandContext) => Command | undefined;
     };
@@ -435,25 +454,30 @@ export declare const CAMERA_MEMBERS: {
      * Live-view quality, the pair to {@link CAMERA_MEMBERS.recordingQuality} and a different setting on a
      * different wire: changing one leaves the other's parameter untouched.
      *
-     * The READ is 1020, which reports the resolved tier as a plain integer. 1020 is also the name the
-     * param dictionary already gives that id, and `Device` keys state by NAME — a member claiming 2730
-     * under this name would collide with it on a device reporting both.
+     * The READ is 1020, which reports the resolved tier as a plain integer, while the WRITE rides 2730's
+     * `1350` payload. They are two ids for one setting because 2730 carries a per-mode config and 1020
+     * carries the tier in force; the tier is what this property means. 1020 is also the name the param
+     * dictionary already gives that id, and `Device` keys state by NAME — a member claiming 2730 under
+     * this name would collide with it on a device reporting both.
      *
-     * `unverified: true` with no `write`: the app's 2730 frame is captured byte-exact, but replaying it
-     * from this SDK produced no observable change on a standalone T8171, where the recording sibling's
-     * 2731 write on the same envelope and the same session does land. The one difference the capture
-     * shows is that the app's frame carries no `mChannel`/`mValue3`, which this envelope always emits.
-     * Until a send is confirmed, the setter is absent — a control that silently does nothing is worse
-     * than none — and the read ships ahead of it, which verification per direction allows.
+     * `transaction` is part of the frame that was captured, so it is sent. The recording sibling's own
+     * confirmed frame carries no such field; neither is inferred from the other.
      */
     readonly streamingQuality: {
+        readonly accepts: StreamingQualityName;
         readonly param: 1020;
         readonly type: "number";
         readonly kind: "enum";
         readonly enumValues: Readonly<Record<number, string>>;
         readonly provenance: "verified";
-        readonly unverified: true;
+        readonly available: typeof isCameraCodec;
+        readonly args: readonly [{
+            readonly name: "quality";
+            readonly kind: "enum";
+            readonly description: "A tier, or the name it maps to. 0 is Auto.";
+        }];
         readonly description: string;
+        readonly write: (v: string | number | boolean, ctx: CommandContext) => Command | undefined;
     };
     /**
      * `type` is how the value is STORED, and 2731 stores the whole config — the ACTIVE tier is lifted out
@@ -465,6 +489,7 @@ export declare const CAMERA_MEMBERS: {
         readonly param: 2731;
         readonly type: "string";
         readonly provenance: "verified";
+        readonly available: typeof isCameraCodec;
         readonly decode: (raw: unknown) => number | undefined;
         readonly decodedKind: "enum";
         readonly decodedValues: number[];
@@ -486,6 +511,7 @@ export declare const CAMERA_MEMBERS: {
         readonly type: "bool";
         readonly kind: "boolean";
         readonly provenance: "apk";
+        readonly available: typeof isCameraCodec;
         readonly description: string;
         readonly requires: readonly [1015];
         readonly write: (v: string | number | boolean, ctx: CommandContext) => Command;
@@ -503,6 +529,7 @@ export declare const CAMERA_MEMBERS: {
         readonly kind: "boolean";
         readonly writeOnly: true;
         readonly provenance: "verified";
+        readonly available: typeof isCameraCodec;
         readonly description: "Privacy mode (PRIVACY_MODE 6250) — the multi-frame burst the sink plays.";
         readonly write: (v: string | number | boolean, ctx: CommandContext) => Command;
     };
@@ -516,6 +543,7 @@ export declare const CAMERA_MEMBERS: {
         readonly type: "bool";
         readonly kind: "boolean";
         readonly provenance: "verified";
+        readonly available: typeof isCameraCodec;
         readonly readAvailable: (ctx: AvailabilityContext) => boolean;
         readonly readAliases: readonly [{
             readonly paramType: 1716;
@@ -525,6 +553,7 @@ export declare const CAMERA_MEMBERS: {
         readonly description: "Camera status LED. Video doorbells report the same state under their button-ring LED parameter.";
         readonly write: (v: string | number | boolean, ctx: CommandContext) => Command;
     };
+    readonly views: import("./members.js").ProvidedMember<"media", (() => readonly number[]) | undefined>;
     /**
      * Media is not a property: it returns DATA rather than moving state, its options are richer than a
      * value, and it exists only on a device bound to a provider. Each is declared once, with its
@@ -542,21 +571,21 @@ export declare const CAMERA_MEMBERS: {
      * The refusal REJECTS on the four that answer with a promise, and THROWS on
      * {@link CAMERA_MEMBERS.recordFragments}, which answers with a handle.
      */
-    readonly snapshotStored: import("./members.js").ProvidedMember<"media", (() => Promise<Buffer<ArrayBufferLike>>) | undefined>;
-    readonly snapshotLive: import("./members.js").ProvidedMember<"media", (opts?: Parameters<MediaProvider["snapshotLive"]>[0]) => Promise<{
+    readonly snapshotStored: import("./members.js").ProvidedMember<"media", false | (() => Promise<Buffer<ArrayBufferLike>>) | undefined>;
+    readonly snapshotLive: import("./members.js").ProvidedMember<"media", false | ((opts?: Parameters<MediaProvider["snapshotLive"]>[0]) => Promise<{
         jpeg: Buffer;
         width: number;
         height: number;
         retained?: true;
-    }>>;
+    }>)>;
     readonly live: import("./members.js").ProvidedMember<"media", (opts?: Parameters<MediaProvider["live"]>[0]) => Promise<import("../../core/contracts.js").LiveStreamConsumer>>;
-    readonly record: import("./members.js").ProvidedMember<"media", (seconds: number, opts?: {
+    readonly record: import("./members.js").ProvidedMember<"media", false | ((seconds: number, opts?: {
         timeoutMs?: number;
         skipKeyframes?: number;
-    } | undefined) => Promise<Buffer<ArrayBufferLike>>>;
-    readonly openReadable: import("./members.js").ProvidedMember<"media", ((opts?: Parameters<NonNullable<MediaProvider["openReadable"]>>[0]) => Promise<import("node:stream").Readable>) | undefined>;
-    readonly recordFragments: import("./members.js").ProvidedMember<"media", ((opts?: Parameters<NonNullable<MediaProvider["recordFragments"]>>[0]) => import("../../core/contracts.js").FragmentRecordingHandle) | undefined>;
-    readonly downloadRecording: import("./members.js").ProvidedMember<"media", ((opts: Parameters<NonNullable<MediaProvider["downloadRecording"]>>[0]) => Promise<import("../../core/contracts.js").RecordingDownload>) | undefined>;
+    } | undefined) => Promise<Buffer<ArrayBufferLike>>)>;
+    readonly openReadable: import("./members.js").ProvidedMember<"media", false | ((opts?: Parameters<NonNullable<MediaProvider["openReadable"]>>[0]) => Promise<import("node:stream").Readable>) | undefined>;
+    readonly recordFragments: import("./members.js").ProvidedMember<"media", false | ((opts?: Parameters<NonNullable<MediaProvider["recordFragments"]>>[0]) => import("../../core/contracts.js").FragmentRecordingHandle) | undefined>;
+    readonly downloadRecording: import("./members.js").ProvidedMember<"media", false | ((opts: Parameters<NonNullable<MediaProvider["downloadRecording"]>>[0]) => Promise<import("../../core/contracts.js").RecordingDownload>) | undefined>;
     /**
      * Push audio from the host to this camera's speaker. Gated on the **speaker** param specifically —
      * not the `audio` capability, which resolves on a microphone alone and would advertise a speaker the

package/dist/model/capabilities/dp-catalog.d.ts

@@ -15,10 +15,11 @@
 /** The parsed DP capability catalog for one product SKU. */
 export interface DpCatalog {
     /**
-     * For enum-type DPs: the valid integer values as declared in the catalog.
-     * Absent for non-enum DPs (bool, raw, integer, string).
+     * For enum-type DPs: the range members exactly as the catalog lists them, as strings — value names
+     * (`"Quiet"`) or numeric strings (`"0"`), whichever the SKU's catalog uses. What a member means is
+     * the reading capability's to decide. Absent for non-enum DPs (bool, raw, integer, string).
      */
-    readonly enumRanges: ReadonlyMap<number, readonly number[]>;
+    readonly enumRanges: ReadonlyMap<number, readonly string[]>;
 }
 /** Returned whenever the API call fails or the response shape is not recognised. */
 export declare const EMPTY_DP_CATALOG: DpCatalog;

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

@@ -42,8 +42,11 @@ import type { VacuumCleanActions } from "./vacuum-clean.js";
 import type { VacuumDockActions } from "./vacuum-dock.js";
 import type { DisplayActions } from "./display.js";
 import type { SuctionActions } from "./suction.js";
+import type { MowerActions } from "./mower.js";
 import type { LocateActions } from "./locate.js";
+import type { SmartDropActions } from "./smart-drop.js";
 import type { DeviceInfo } from "./info.js";
+import type { CusPushAlarmType } from "../push-events.js";
 /**
  * Look up the {@link CapabilityModule} for a capability, or `undefined` if none is registered.
  * @internal
@@ -296,9 +299,13 @@ export interface DeviceEventMap {
      * can be known about a value nothing pushes.
      */
     cameraEnabledChanged: PushSemanticEvent;
-    /** Station alarm lifecycle; `phase` says whether it fired or is counting down. */
+    /**
+     * Station alarm lifecycle; `phase` says whether it fired, is counting down, or was stopped. `type` is
+     * the push's alarm source or stop reason, absent when the push carried none.
+     */
     alarm: PushSemanticEvent & {
-        phase?: "triggered" | "delayed";
+        phase?: "triggered" | "delayed" | "stopped";
+        type?: CusPushAlarmType;
     };
     /** Lock (un)locked or a lock alarm fired. */
     lockState: PushSemanticEvent;
@@ -421,8 +428,12 @@ export interface DeviceActionMap {
     vacuumDock: VacuumDockActions;
     /** RoboVac suction: `level`, `boostIq`, `supportedLevels`; `setSuctionLevel`, `setBoostIq`. */
     suction: SuctionActions;
+    /** Robot mower (read-only): `battery`, `cutHeight`, `network`, `wifiSignal`, wear timers and settings. No write is captured. */
+    mower: MowerActions;
     /** RoboVac locate (find-robot beep): `locating`; `locate(on?)`. */
     locate: LocateActions;
+    /** SmartDrop parcel box: `openLid()`. */
+    smartDrop: SmartDropActions;
     /** Smart Display (read-only): `battery`. No display write is captured. */
     display: DisplayActions;
     /** Identity metadata (read-only): `{ manufacturer, model, serialNumber, name, deviceType?, firmwareVersion?, hardwareVersion? }`. */
@@ -516,7 +527,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, LocateActions, };
+export type { PtzActions, LightActions, SmartLightActions, RgbColor, CameraActions, LockActions, SirenActions, ArmingActions, BatteryActions, MotionActions, ContactActions, LeakActions, SmokeActions, CoActions, KeypadActions, 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.
@@ -541,10 +552,12 @@ export { MOTION_MEMBERS } from "./motion.js";
 export { PTZ_MEMBERS } from "./ptz.js";
 export { RTSP_MEMBERS } from "./rtsp.js";
 export { SIREN_MEMBERS } from "./siren.js";
+export { SMART_DROP_MEMBERS } from "./smart-drop.js";
 export { SMART_LIGHT_MEMBERS } from "./smart-light.js";
 export { SMOKE_MEMBERS } from "./smoke.js";
 export { DISPLAY_MEMBERS, type DisplayActions } from "./display.js";
 export { SUCTION_MEMBERS } from "./suction.js";
+export { MOWER_MEMBERS } from "./mower.js";
 export { VACUUM_CLEAN_MEMBERS } from "./vacuum-clean.js";
 export type { DeviceInfo } from "./info.js";
 export type { AutoSpotlightOptions } from "./light.js";

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

@@ -160,6 +160,9 @@ export declare const LIGHT_MEMBERS: {
      * This is the switch a user changes and expects to STAY changed. {@link isOn} is a different fact:
      * the lamp being lit right now, driven by whichever
      * client is streaming — the vendor app lights it for a live view and drops it on quitting.
+     *
+     * The T8423 write takes the session-chosen level; level-1 int+string was verified live on a standalone
+     * unit.
      */
     readonly spotlightEnabled: {
         readonly param: 1403;

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

@@ -1,6 +1,6 @@
 import { type Surface } from "./members.js";
 import type { AvailabilityContext, CapabilityModule, CommandContext } from "./types.js";
-import type { Command, AutoLockSnapshot } from "../../core/contracts.js";
+import type { Command, AutoLockSnapshot, MediaProvider } from "../../core/contracts.js";
 /**
  * Setting-id selectors for the compact `ff09-setting-toggle` write — this capability's OWN wire
  * vocabulary, named not inlined per the capability wire-id convention, so `setRainMode`
@@ -107,10 +107,14 @@ export declare const LOCK_MEMBERS: {
         readonly provenance: "verified";
         readonly description: "Lock signal strength (verified: param 1141 = RSSI).";
     };
-    /** Lock the deadbolt/door. Fire-and-forget — rejects only on missing member identity, never on a device timeout. */
-    readonly lock: import("./members.js").MethodMember<() => Promise<void>>;
-    /** Unlock the deadbolt/door. Fire-and-forget — rejects only on missing member identity. */
-    readonly unlock: import("./members.js").MethodMember<() => Promise<void>>;
+    /** Lock the deadbolt/door. Resolves after sending; does not confirm physical state. */
+    readonly lock: import("./members.js").MethodMember<() => Promise<void>> & {
+        available: (ctx: CommandContext) => boolean;
+    };
+    /** Unlock the deadbolt/door. Resolves after sending; does not confirm physical state. */
+    readonly unlock: import("./members.js").MethodMember<() => Promise<void>> & {
+        available: (ctx: CommandContext) => boolean;
+    };
     /**
      * Read-modify-write the auto-lock setting: the transport GETs the device's current settings, changes
      * only `enabled` (+ `delaySeconds` if given — otherwise the current delay is preserved), and writes the
@@ -120,7 +124,9 @@ export declare const LOCK_MEMBERS: {
      * **Unlike `lock`/`unlock` this can reject on a device TIMEOUT**, not just missing identity — the GET
      * step is a genuine precondition, so this one is not fire-and-forget.
      */
-    readonly setAutoLock: import("./members.js").MethodMember<(enabled: boolean, delaySeconds?: number) => Promise<void>>;
+    readonly setAutoLock: import("./members.js").MethodMember<(enabled: boolean, delaySeconds?: number) => Promise<void>> & {
+        available: (ctx: CommandContext) => boolean;
+    };
     /**
      * Toggle Rain Mode — a pure blind write, unlike `setAutoLock`: the compact frame carries only this one
      * field, so there is no GET pass and it is fire-and-forget. Confirmed on-device end-to-end in both
@@ -220,6 +226,14 @@ export declare const LOCK_MEMBERS: {
         readonly description: "One-touch rear locking (setting-id 11). Wire shape confirmed in the app's own JS, NOT captured.";
         readonly write: (v: string | number | boolean, ctx: CommandContext) => Command;
     };
+    /** Read the current device-reported state; undefined means no settled locked/unlocked state. */
+    readonly refreshStatus: {
+        readonly needs: "media";
+        readonly provided: (provider: MediaProvider, deps: import("./members.js").MemberDeps) => (() => Promise<boolean | undefined>) | undefined;
+        readonly description: string;
+        readonly requiredCapabilities?: readonly import("../types.js").Capability[];
+        readonly answers: true;
+    };
     /**
      * Read the device's current auto-lock settings via a live `GET_SETTINGS` round-trip — the SAME read
      * `setAutoLock` does internally, exposed standalone with no write attached. Works over BOTH transports.
@@ -230,7 +244,7 @@ export declare const LOCK_MEMBERS: {
      */
     readonly getAutoLockState: {
         readonly needs: "ff09Settings";
-        readonly provided: (provider: import("../../core/contracts.js").Ff09SettingsReader, deps: import("./members.js").MemberDeps) => () => Promise<AutoLockSnapshot>;
+        readonly provided: (provider: import("../../core/contracts.js").Ff09SettingsReader, deps: import("./members.js").MemberDeps) => (() => Promise<AutoLockSnapshot>) | undefined;
         readonly description: string;
         readonly requiredCapabilities?: readonly import("../types.js").Capability[];
         readonly answers: true;

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

@@ -182,6 +182,11 @@ export interface AiDetectFlags {
 export declare function encodeAiDetectType(flags: AiDetectFlags): number;
 /** Decode an `ai_detect_type` bitmask → which detection types are on. */
 export declare function decodeAiDetectType(value: number): AiDetectFlags;
+/**
+ * The `ai_detect_type` bitmask from a stored 1298 value: the bare number, or the numeric
+ * `ai_detect_type` field of the JSON object form. Answers `undefined` for any other shape.
+ */
+declare function decodeAiDetectTypeParam(raw: unknown): number | undefined;
 /**
  * Decode a `radar_wd_switch` (2706, loitering) read the way the app does:
  * `typeof v === "object" ? v.radar_wd_switch : v`. The device may store it as a JSON object
@@ -245,11 +250,15 @@ export declare const MOTION_MEMBERS: {
      * 1298 holds the detailed AI-type BITMASK (live-observed: `0x30000` enabled-base | type bits, e.g. a
      * T8425 reads `0x3000f`). Cams also report 1299 (`hbAiDetectType`) but that is a separate, simpler
      * value (1) — NOT this bitmask, so 1298 is the read/write id.
+     *
+     * The value arrives in two shapes, both read by the app's 1298 parser: a bare bitmask, or a JSON
+     * object carrying the same bitmask as `ai_detect_type` (see {@link decodeAiDetectTypeParam}).
      */
     readonly aiDetectType: {
         readonly param: 1298;
-        readonly type: "number";
-        readonly kind: "bitfield";
+        readonly type: "string";
+        readonly decode: typeof decodeAiDetectTypeParam;
+        readonly decodedKind: "bitfield";
         readonly provenance: "verified";
         readonly description: string;
         readonly write: (v: string | number | boolean, ctx: CommandContext) => Command | undefined;
@@ -271,6 +280,10 @@ export declare const MOTION_MEMBERS: {
      * The raw sensitivity an indoor camera reports, on the one id whose write takes a `1700` control
      * payload carrying an index rather than the `1350` envelope its siblings use — a frame-shape
      * difference `sensitivityCommand` resolves from the scale. `unexposed` like its three siblings.
+     *
+     * Some devices report 6041 as a base64 JSON list of per-sensor entries
+     * (`{"list":[{"sensor_id":…,"sensitivity":…}]}`) rather than a scalar. That value is stored verbatim
+     * and this getter answers `undefined` for it: only the scalar form is confirmed to be this step.
      */
     readonly indoorSensitivity: {
         readonly param: 6041;
@@ -279,6 +292,7 @@ export declare const MOTION_MEMBERS: {
         readonly provenance: "verified";
         readonly unexposed: true;
         readonly description: "Raw sensitivity an indoor camera reports (verified: param 6041).";
+        readonly decode: (raw: unknown) => number | undefined;
     };
     /**
      * The raw sensitivity on the INVERTED seven-step camera scale — a HIGHER number is LESS sensitive, so
@@ -374,3 +388,4 @@ export declare const MOTION_MEMBERS: {
     };
 };
 export declare const MOTION: CapabilityModule;
+export {};