@mega-yfue/eufy-sdk 0.6.0-beta.0 → 0.6.0-beta.10

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

@@ -204,6 +204,7 @@ export declare const ARMING_MEMBERS: {
      * MODE_SWITCH carries no value. Live qualification on a standalone camera showed that authoritative
      * readback requires a bounded cloud-list refresh, and that its P2P session must be reset after
      * convergence before a following mode write; an attached device must never reset its shared HomeBase.
+     * A standalone T8423's level-1 session is kept open instead.
      */
     readonly mode: {
         readonly accepts: ArmingMode;

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

@@ -475,6 +475,8 @@ export declare const CAMERA_MEMBERS: {
      *
      * `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.
+     *
+     * Not offered where the device reports the doorbell's own live-view quality (1705).
      */
     readonly streamingQuality: {
         readonly accepts: StreamingQualityName;
@@ -483,7 +485,7 @@ export declare const CAMERA_MEMBERS: {
         readonly kind: "enum";
         readonly enumValues: Readonly<Record<number, string>>;
         readonly provenance: "verified";
-        readonly available: typeof isCameraCodec;
+        readonly available: (ctx: AvailabilityContext) => boolean;
         readonly args: readonly [{
             readonly name: "quality";
             readonly kind: "enum";

package/dist/model/device-family.d.ts

@@ -52,7 +52,7 @@ export declare const isHomeBase: (ctx: FamilyContext) => boolean;
 export declare const isStation9000: (ctx: FamilyContext) => boolean;
 /** T8N00 NVR, identified by its reported model. */
 export declare const isNvrT8N00: (ctx: FamilyContext) => boolean;
-/** PoE cameras whose media is served by their NVR's portal call. */
+/** A camera attached to a T8N00 whose media the NVR's call serves. */
 export declare const isNvrMediaCamera: (ctx: FamilyContext) => boolean;
 /** PoE S4 camera with independently streamed fixed and movable optical views. */
 export declare const isNvrDualLensCamera: (ctx: FamilyContext) => boolean;

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

@@ -171,7 +171,11 @@ export declare class P2PCommandRouter {
      * serial itself if the device isn't loaded (a standalone device is its own station).
      */
     stationKeyOf(sn: string): string;
-    /** Reset only a standalone device's session; an attached device must not close its shared HomeBase. */
+    /**
+     * Reset only a standalone device's session; an attached device must not close its shared HomeBase.
+     *
+     * A {@link KEEP_LEVEL1_SESSION_MODELS} station whose open session holds no level-2 key is left open.
+     */
     resetStandaloneSession(sn: string): Promise<void>;
     /**
      * Open (or reuse) the P2P session for a station **on demand**, coalescing concurrent cold opens via

package/dist/transport/p2p/level2-settle.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The bound a caller waits for the level-2 negotiation to SETTLE, measured from connect.
+ *
+ * For a caller that picks its seal once from `P2PSession.hasLevel2Key` and has no second chance. A media
+ * start reads the key on every send and is re-issued by the warm-up, so it needs no wait; a property write
+ * framed level-1 to a family that only accepts level-2 is ignored, and nothing re-frames it. Session-scoped,
+ * so a station that offers no key does not charge this to every later command.
+ */
+export declare const LEVEL2_SETTLE_MS = 8000;

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

@@ -676,6 +676,12 @@ export declare class P2PSession extends EventEmitter {
         query?: Record<string, unknown>;
         innerCmd?: number;
     }): void;
+    /**
+     * The `CMD_SET_PAYLOAD` payload of a database read or stored-image request: the JSON level-1 encrypted, or
+     * in the clear with header bytes from {@link nextClearCommandBytes} on a session that {@link sendsInTheClear}
+     * and holds no level-2 key.
+     */
+    private databasePayload;
     /**
      * Standard "give me the whole table" query params the eufy app uses for a direct
      * `CMD_DATABASE` read (inner `cmd 10000`). `count` bounds the row count.
@@ -719,6 +725,9 @@ export declare class P2PSession extends EventEmitter {
      *
      * One read at a time per session: while one is accumulating, every {@link queryDatabase} on the
      * session throws, so a second reply cannot land in this buffer.
+     *
+     * The query's framing follows the cipher the gateway-info reply names, so on a session still negotiating
+     * its level-2 key the query waits for that to settle, up to {@link LEVEL2_SETTLE_MS} from connect.
      */
     readDatabase(table: string, opts?: {
         accountId?: string;

package/dist/transport/p2p/shared-live-source.d.ts

@@ -376,8 +376,13 @@ export declare class SharedLiveSource {
     private isKeyframe;
     /**
      * Handle a consumer leaving. When the last one detaches (1→0), release the station-session user via
-     * {@link SharedLiveSourceOptions.onIdle} (its own longer idle timer then arms) and arm the stream's
-     * linger teardown.
+     * {@link SharedLiveSourceOptions.onIdle} (its own longer idle timer then arms) and, while a stream is
+     * still running, arm its linger teardown.
+     *
+     * A source that ended its own stream ends its consumers before tearing down, and a Readable consumer
+     * detaches only once it has reached EOF — after that teardown. The source is then already `stopped`,
+     * with its session claim released, and stays so: lingering would make the owner hand it out again
+     * instead of building a source that holds a session.
      */
     private onDetach;
     /** Refcount hit zero — arm the linger teardown. A new attach in the window cancels it. */

package/package.json

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