@mega-yfue/eufy-sdk 0.5.0-beta.1 → 0.5.0-beta.11

package/dist/client/eufy-mega.d.ts

@@ -98,6 +98,8 @@ export declare class EufyMega extends EventEmitter {
     private readonly prewarmTiers;
     /** Transport-side owner of the P2P sessions + all wire senders. */
     private readonly p2p;
+    /** Transport-side owner of the T9000 station sessions (sibling of {@link p2p}). */
+    private readonly rtc;
     /** Transport-side owner of the secure-MQTT ff09 lock/garage command path (sibling of {@link p2p}). */
     private readonly mqtt;
     /** Transport-side owner of the legacy Tuya REST command path for non-AIoT vacuums (G-series). */
@@ -234,6 +236,11 @@ export declare class EufyMega extends EventEmitter {
      *
      * The evidence set is widened, never replaced: the ids come back through the cloud record, and a
      * record that omits a realtime-only id would otherwise un-know it and re-trigger on the next report.
+     *
+     * The device is re-resolved against the fresh record before binding. A property gated on a
+     * realtime-only param enters the schema only once that param is evidence, and the value that made it
+     * evidence was stored before the property existed, so the record's realtime params are applied again
+     * to land it under the property's name.
      */
     private rebindReads;
     /** The distinct credential scopes the current MQTT roster needs — no devices on a scope, no connection. */
@@ -261,6 +268,8 @@ export declare class EufyMega extends EventEmitter {
      * only "differs from what was read before", which state already on hand can satisfy spuriously — and the
      * caller that has no expectation is the push path, where the signal itself is the news that a re-read is owed.
      *
+     * Only a write's observation throws at the deadline; a push with nothing moved answers `false`.
+     *
      * The cloud half is asked for through {@link DeviceRegistry.refreshedList}, never by fetching the account
      * list outright. The fetch is account-wide — one house list plus one device list per house — so a param that
      * never converges would otherwise spend a whole burst of those every iteration of this loop, and concurrent
@@ -409,8 +418,9 @@ export declare class EufyMega extends EventEmitter {
      * The `eufy_life` DP writes (smart lights) are secure-MQTT-only. `aiot-dp` routes to either the
      * Anker AIoT MQTT stack or the legacy Tuya REST router depending on the device's category
      * (`eufy_home_tuya` → Tuya, everything else → MQTT). The capability layer emits a single `aiot-dp`
-     * kind and stays transport-agnostic; only the facade sees both sides and decides here. Everything
-     * else is P2P.
+     * kind and stays transport-agnostic; only the facade sees both sides and decides here. A T9000
+     * station and the devices attached to it go over RTC, with an attached device's command refused
+     * unless its channel resolves back to it on the station. Everything else is P2P.
      */
     private routeCommand;
     /**
@@ -835,11 +845,14 @@ export declare class EufyMega extends EventEmitter {
      */
     setProperty(sn: string, name: string, value: boolean | number | string): Promise<void>;
     /**
-     * Restart a HomeBase.
+     * Restart a station: a HomeBase, or a camera-family device that is its own station.
      *
-     * **HomeBases only** — restart is a hub operation, so a non-HomeBase serial (a camera, an NVR)
-     * throws rather than doing nothing. The hub drops its connection and returns after a minute or two,
-     * so everything behind it is briefly offline. Verified on real hardware.
+     * The restart is `RESTART_HUB` on the station's broadcast channel, so it reaches whatever owns the
+     * P2P session. A standalone camera or doorbell owns its own session and is the station it restarts.
+     * A camera attached to a HomeBase is not — the same frame would restart its HomeBase — so its serial
+     * throws, as does any non-camera serial, rather than doing nothing. The device drops its connection
+     * and returns after a minute or two; a HomeBase takes everything behind it offline meanwhile.
+     * Verified on real hardware against a HomeBase and a standalone indoor camera.
      */
     reboot(sn: string): Promise<void>;
     /**
@@ -857,6 +870,7 @@ export declare class EufyMega extends EventEmitter {
      * exactly the reads it has.
      */
     private fetchDpCatalog;
+    /** The {@link CommandContext} for a device, built from `known` when that record is already in hand. */
     private commandContext;
     /**
      * **Generic P2P request/reply query** — sends a `SET_PAYLOAD` sub-command and resolves with the

package/dist/client/types.d.ts

@@ -390,7 +390,7 @@ export type EufyMegaEventMap = {
             sn: string;
             property: string;
             param: number;
-            expected?: boolean | number | string;
+            expected: boolean | number | string;
             observed?: boolean | number | string;
             timeoutMs: number;
         }

package/dist/core/contracts.d.ts

@@ -230,7 +230,7 @@ export interface StateConvergenceFailure {
     property: string;
     param: number;
     /** The RAW param value the write asked the device to report. */
-    expected?: boolean | number | string;
+    expected: boolean | number | string;
     /** What the param actually read when the deadline passed, absent where the device reported none at all. */
     observed?: boolean | number | string;
     timeoutMs: number;
@@ -248,7 +248,7 @@ export declare class StateConvergenceError extends Error {
     readonly sn: string;
     readonly property: string;
     readonly param: number;
-    readonly expected?: boolean | number | string;
+    readonly expected: boolean | number | string;
     readonly observed?: boolean | number | string;
     readonly timeoutMs: number;
     constructor(failure: StateConvergenceFailure);

package/dist/core/store.d.ts

@@ -16,6 +16,8 @@ export interface PersistedSession {
     authToken: string;
     geoKey?: string;
     region: RegionShard;
+    /** The host `estimate_domain` answered; it names shards the region classification cannot (`ie`). */
+    estimatedDomain?: string;
     openudid: string;
     /** This install's reported device model + media user-agent, generated once and reused. */
     phoneModel?: string;