@mega-yfue/eufy-sdk 0.6.0-beta.43 → 0.6.0-beta.45

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

@@ -1,4 +1,4 @@
-import type { CapabilityModule, CommandContext } from "./types.js";
+import type { CapabilityModule, CommandContext, AvailabilityContext } from "./types.js";
 import { type Surface } from "./members.js";
 import type { Command } from "../../core/contracts.js";
 /**
@@ -54,10 +54,10 @@ export type AutoSpotlightOptions = {
  * is written out below.
  */
 export type LightActions = Surface<typeof LIGHT_MEMBERS> & {
-    /** Turn the light on. Throws if this model's switch wire is unverified. */
-    on(): Promise<void>;
-    /** Turn the light off. Throws if this model's switch wire is unverified. */
-    off(): Promise<void>;
+    /** Turn the light on. Absent on a model whose switch wire is unverified. */
+    on?(): Promise<void>;
+    /** Turn the light off. Absent on a model whose switch wire is unverified. */
+    off?(): Promise<void>;
     /**
      * Enable/disable the **motion-activated light** (auto-spotlight): the spotlight lights up when the
      * camera detects motion.
@@ -93,9 +93,8 @@ export declare const LIGHT_MEMBERS: {
      * So it reads on whenever any client is watching. The setting a user changes and expects to persist
      * is {@link spotlightEnabled}.
      *
-     * The switch refuses for a reason a value check cannot give — this model's frame SHAPE is unconfirmed —
-     * so `switchFrame` throws that reason and `bindMembers` turns it into the rejection, rather than
-     * letting the generated "not a valid value" blame a boolean that was never the problem.
+     * The switch frame SHAPE is per family ({@link lightSwitchWire}), and the write is `unverifiedFor` the
+     * families it has no shape for.
      */
     readonly isOn: {
         readonly param: 1400;
@@ -104,7 +103,8 @@ export declare const LIGHT_MEMBERS: {
         readonly kind: "boolean";
         readonly provenance: "verified";
         readonly description: string;
-        readonly write: (v: string | number | boolean, ctx: CommandContext) => Command;
+        readonly write: (v: string | number | boolean, ctx: CommandContext) => Command | undefined;
+        readonly unverifiedFor: (ctx: AvailabilityContext) => boolean;
         readonly writeAs: "set";
         readonly aliases: {
             readonly on: true;

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

@@ -142,6 +142,13 @@ export interface ValueMember {
      * distinction the intent path answers with rather than a generic "not supported".
      */
     unverified?: true;
+    /**
+     * {@link unverified}, decided per device: the write wire is confirmed on some families and not on the
+     * one this predicate answers `true` for. There the setter is not installed and the intent path throws,
+     * exactly as for a member that is unverified everywhere. Like `available`, a member that declares this
+     * lands its setter OPTIONAL on the surface, because whether it exists is a runtime fact.
+     */
+    unverifiedFor?: (ctx: AvailabilityContext) => boolean;
     /**
      * Extra names the intent path should route here, taking the caller's value as-is. Unlike
      * {@link aliases}, no value is supplied: it is the same write under a second name.
@@ -469,9 +476,13 @@ export type UnverifiedKeys<M extends Members> = {
 /**
  * Members whose presence is a runtime fact, so the surface must make a caller check: a write installed
  * only on the devices that prove they speak it ({@link ValueMember.requires}), or one whose wire is not
- * captured ({@link ValueMember.unverified}).
+ * captured ({@link ValueMember.unverified}) everywhere or on some families ({@link ValueMember.unverifiedFor}).
  */
 export type ConditionalKeys<M extends Members> = UnverifiedKeys<M> | {
+    [K in keyof M]: M[K] extends {
+        unverifiedFor: unknown;
+    } ? K : never;
+}[keyof M] | {
     [K in keyof M]: M[K] extends {
         requires: readonly number[];
     } ? K : never;
@@ -632,8 +643,9 @@ export declare function kindRoutable(kind: Command["kind"], ctx: AvailabilityCon
  *    identity and says so by throwing) and a method returning `Promise<void>` must not surprise a caller
  *    chaining `.catch()`. Caught here once rather than in each module's own wrapper.
  *
- * A getter is skipped for a `writeOnly` or `unexposed` member, and a setter for an `unverified` one —
- * declared so the capability documents the device, never installed.
+ * A getter is skipped for a `writeOnly` or `unexposed` member, and a setter for an `unverified` one, or
+ * one whose `unverifiedFor` holds for this device — declared so the capability documents the device,
+ * never installed.
  */
 export declare function bindMembers<M extends Members>(members: M, deps: MemberDeps): Surface<M>;
 /**

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/package.json

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