@mega-yfue/eufy-sdk 0.6.0-beta.5 → 0.6.0-beta.7

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.5",
+  "version": "0.6.0-beta.7",
   "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",