@mega-yfue/eufy-sdk 0.5.0-beta.45 → 0.5.0-beta.47

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

@@ -65,6 +65,7 @@ export declare class RtcCommandRouter {
     private readonly deps;
     private readonly sessions;
     private readonly lives;
+    private readonly warm;
     constructor(deps: RtcCommandRouterDeps);
     dispatchCommand(route: RtcRoute, cmd: Command): Promise<void>;
     /**
@@ -104,6 +105,24 @@ export declare class RtcCommandRouter {
      * rejecting unheard.
      */
     private bringUp;
+    /**
+     * Hold a station's command session open: one hold per station, its idle-close ({@link IDLE_CLOSE_MS})
+     * suppressed, {@link PORTAL_KEEPALIVE} sent every {@link PORTAL_KEEPALIVE_MS}, and the session dropped
+     * on a tick that finds the previous keepalive unechoed. A closed session ends the hold.
+     *
+     * Answers an idempotent disposer that releases the hold. Throws when no account is logged in.
+     */
+    keepWarm(route: RtcRoute): () => void;
+    /**
+     * Bring a station session up for a {@link keepWarm} hold and start its keepalive. A bring-up that fails,
+     * or a hold disposed before it completes, clears the hold and arms no timer. Each tick first checks
+     * that the hub echoed the previous keepalive, and drops the session when it did not. The keepalive
+     * stops when the session closes, which also clears the hold so the next command or `keepWarm`
+     * rebuilds cleanly.
+     */
+    private warmUp;
+    /** Stop a hold's keepalive and remove its listeners from the session it watches. */
+    private unwatch;
     private touch;
     private drop;
 }

package/dist/transport/rtc/peer.d.ts

@@ -37,6 +37,8 @@ export interface RtcPeerEvents {
     /** The command channel went away while the peer itself may still be up. */
     commandChannelClosed: [];
     data: [frame: Buffer, linkType: number];
+    /** The hub echoed the portal keepalive on the command channel. */
+    keepaliveEcho: [];
     iceCandidate: [candidate: string];
     iceGatheringComplete: [];
     connectionState: [state: string];
@@ -93,7 +95,8 @@ export declare class RtcPeer extends EventEmitter<RtcPeerEvents> {
     private createChannels;
     /**
      * Wire one data channel. Every channel feeds the framer once the command channel has opened it; a
-     * message before that has nothing to reassemble into and is dropped.
+     * message before that has nothing to reassemble into and is dropped. The hub's echo of the portal
+     * keepalive on the command channel is unframed and surfaces as `keepaliveEcho` instead.
      */
     private wireChannel;
     private addNow;

package/dist/transport/rtc/portal-keepalive.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The portal's data-channel keepalive for an RTC session.
+ *
+ * {@link PORTAL_KEEPALIVE} is the 36 bytes the portal sends unframed on the data channel — a 20-byte
+ * prefix then a bare `XZYH 1139`, no portal packet header — and the hub echoes it. Sent every
+ * {@link PORTAL_KEEPALIVE_MS}, it stops the hub idling the session out.
+ */
+/** The portal's 36-byte data-channel keepalive: a 20-byte prefix and a bare `XZYH 1139`. */
+export declare const PORTAL_KEEPALIVE: Buffer<ArrayBuffer>;
+/** How often {@link PORTAL_KEEPALIVE} goes out on an RTC session. */
+export declare const PORTAL_KEEPALIVE_MS = 29000;

package/dist/transport/rtc/session.d.ts

@@ -35,6 +35,8 @@ export interface RtcSessionEvents {
     commandData: [frame: Buffer, linkType: number];
     /** A reassembled live-video frame. */
     mediaData: [frame: Buffer];
+    /** The hub echoed the portal keepalive on the command channel. */
+    keepaliveEcho: [];
 }
 export declare class RtcSession extends EventEmitter<RtcSessionEvents> {
     private readonly opts;

package/package.json

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