@mega-yfue/eufy-sdk 0.6.0-beta.37 → 0.6.0-beta.39

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

@@ -128,12 +128,9 @@ export declare const CELL_PARAMS: readonly number[];
  */
 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.
- *
- * Each write is gated on the device reporting the param it reads back, because "has a battery" is much
- * weaker evidence than "speaks this setting": an entry sensor reports a level (1101) and nothing else,
- * and handing it a power-source frame it never accepts would look like success.
+ * The published `battery` table: the full camera surface, minus every member on the `sensor` codec —
+ * a sensor's 1101 is a non-cell sentinel and it has none of the camera power reads, so it exposes no
+ * battery entity (see {@link notOnSensor}). Every getter, setter and description derives from this.
  *
  * Exported but NOT published: each entry states its wire id and the evidence it was confirmed on,
  * which the reference site does not carry.

package/dist/transport/p2p/codec.d.ts

@@ -94,6 +94,12 @@ export declare function p2pCommandEncryptionKey(stationSn: string, p2pDid: strin
 export declare function decryptP2PData(data: Buffer, key: Buffer): Buffer;
 /** The `cipher_id` named in a decrypted `CMD_GATEWAYINFO` (1100) payload (uint16 LE @0). */
 export declare function gatewayInfoCipherId(gwPayload: Buffer): number;
+/**
+ * Whether a `CMD_GATEWAYINFO` (1100) reply is a level-2 refusal: int32 LE `GATEWAY_LEVEL2_REFUSED` (`99 ff
+ * ff ff`) in place of a cipher. {@link gatewayInfoCipherId} reads those bytes as `cipher_id` 65433. Any other
+ * opening is not a refusal.
+ */
+export declare function gatewayInfoRefused(gwPayload: Buffer): boolean;
 /** Options for {@link eciesUnwrap}. */
 export interface EciesUnwrapOptions {
     /**

package/dist/transport/p2p/command-router.d.ts

@@ -697,6 +697,9 @@ export declare class P2PCommandRouter {
      * sources on the replaced session are discarded before closing it (see {@link tearDownStation}).
      * Replaced at most once per resolution, so a station whose replacement is silent too is returned rather
      * than closed again.
+     *
+     * `clearFallback` hands over a session whose station {@link P2PSession.refusedLevel2} instead of throwing, for
+     * a standalone device of a model in {@link CLEAR_FF09_MODELS}.
      */
     private resolveSession;
     /**

package/dist/transport/p2p/live-trace.d.ts

@@ -148,7 +148,7 @@ export type LiveTrace =
  */
  | {
     phase: "level2-unavailable";
-    reason: "no-cipher-key" | "derivation-failed" | "not-negotiating" | "session-closed" | "grace-elapsed";
+    reason: "no-cipher-key" | "derivation-failed" | "not-negotiating" | "session-closed" | "grace-elapsed" | "gateway-refused";
     cipherId?: number;
     waitedMs?: number;
 }

package/dist/transport/p2p/p2p-session.d.ts

@@ -224,6 +224,8 @@ export declare class P2PSession extends EventEmitter {
     private readonly liveStartedChannels;
     /** The `cipher_id` this connection's `CMD_GATEWAYINFO` reply named, once its negotiation has read it. */
     private gatewayCipherId?;
+    /** Whether this connection's latest `CMD_GATEWAYINFO` reply was a refusal — see {@link gatewayInfoRefused}. */
+    private gatewayRefused;
     /** The `n` of the last `[0x01, n]` header this connection sent in the clear — see {@link nextClearCommandBytes}. */
     private clearCommandCount;
     private readonly unackedLiveStarts;
@@ -326,7 +328,8 @@ export declare class P2PSession extends EventEmitter {
      * Every outcome settles the wait in {@link awaitLevel2Key}, so a later command is told at once rather than
      * left to time out against a key that is not coming. Settling also re-opens the negotiation, so a later
      * GATEWAYINFO reply in the same connection generation runs it again; a lookup that completes after its
-     * generation ended settles nothing.
+     * generation ended settles nothing. A {@link gatewayInfoRefused} reply names no cipher, so it settles at once
+     * with no cloud lookup, and a later reply naming a cipher withdraws the refusal.
      */
     private negotiateLevel2Key;
     /**
@@ -526,6 +529,11 @@ export declare class P2PSession extends EventEmitter {
     sendIntStringCommand(commandType: number, value: number, valueSub: number, strValue: string, channel?: number): void;
     /** Send a level-1 {@link buildStringPairCommandPayload} command on `channel`. */
     sendStringPairCommand(commandType: number, strValue: string, strValueSub: string, channel: number): void;
+    /**
+     * Whether this connection's station answered `CMD_GATEWAYINFO` with a refusal ({@link gatewayInfoRefused}) and
+     * no key that frames a set-payload is held.
+     */
+    get refusedLevel2(): boolean;
     /**
      * Send a **level-2 (AES-256-GCM, signCode 8) control payload** to a HomeBase-attached device. The
      * target camera is selected by `channel` (= device_channel) + the `mChannel` envelope — the same
@@ -536,8 +544,12 @@ export declare class P2PSession extends EventEmitter {
      * On a session holding only the AES-128-ECB level-2 key of an RSA cipher, the frame is the level-1
      * layout ({@link sendRawLevel1Bytes}) sealed under that key at encryption type 2: the encryption-type
      * byte names the key the body is sealed with (1 = level-1 key, 2 = the negotiated key).
+     *
+     * With `clearOnRefusal` on a session that {@link refusedLevel2}, the frame goes in the clear in the vendor
+     * app's form for such a device: header bytes `[01 00]`, signCode 0, and a body of `{cmd, payload}` alone.
+     * Without it, a refused session answers `false` and sends nothing.
      */
-    sendControlLevel2(cmd: number, channel: number, accountId: string, payload: Record<string, unknown>, mValue3?: number): boolean;
+    sendControlLevel2(cmd: number, channel: number, accountId: string, payload: Record<string, unknown>, mValue3?: number, clearOnRefusal?: boolean): boolean;
     /**
      * Send a **level-2 (GCM, signCode 8) frame whose plaintext is exactly `json`** — no
      * `{account_id,cmd,mChannel,…}` envelope. The target device is selected by the frame-header

package/dist/transport/p2p/video.d.ts

@@ -73,7 +73,7 @@ export declare class VideoFrameDecoder {
 export interface AssembledAccessUnit {
     /** Unsigned 32-bit header timestamp from the first frame of this access unit. */
     sourceTimestamp: number;
-    /** True when the unit's own header flagged it a keyframe — a point a consumer may begin decoding at. */
+    /** True when header bit 0 is set, or (bit 0 clear) the payload contains an IDR — a point to begin decoding at. */
     keyframe: boolean;
     /** Frame width the unit's header declared. */
     width: number;

package/package.json

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