@mega-yfue/eufy-sdk 0.6.0-beta.35 → 0.6.0-beta.36

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

@@ -194,7 +194,8 @@ export declare class RtcCommandRouter {
     /**
      * One bounded bring-up: the session is up when its command channel opens, and it fails, with the
      * session closed and every listener gone, when `connect()` throws, the session closes first (rejecting
-     * with the failure that closed it, when it carries one), or {@link CONNECT_TIMEOUT_MS} passes. A single
+     * with the failure that closed it, when it carries one), or {@link CONNECT_TIMEOUT_MS} passes, naming the
+     * stage the session reached and its peer's last state. A single
      * promise, so an early failure cannot leave a second one rejecting unheard.
      */
     private bringUp;

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

@@ -18,7 +18,9 @@
  * nominally up. A dropped signalling socket closes the peer with it: a hub that still sees the peer
  * answers every later `scall` with 486 until that peer's ICE gives up. A peer that cannot be built when
  * the hub grants the relay ends the session there: the failure is emitted as `error` and `close` fires
- * carrying it.
+ * carrying it. Before the command channel opens, a peer that fails or closes also ends the session, and so
+ * does a hub `hangup` on a `scall` session, the exchange above; {@link RtcSession.stage} names how far
+ * the bring-up got. A `call` session's pre-open hangup is not evidenced as terminal and stays logged only.
  *
  * A session whose peer is a {@link RtcPeerOptions.mediaTrack} peer has no command channel: `close` fires
  * when the peer fails or closes, and the video track's packets are emitted as `rtp`.
@@ -47,6 +49,11 @@ export interface RtcSessionEvents {
     /** One packet of the video track, in a {@link RtcPeerOptions.mediaTrack} session. */
     rtp: [packet: Buffer];
 }
+/**
+ * How far a session's bring-up got, in order: the sign fetch, the signalling socket, its auth, the placed
+ * call, the hub's relay grant, our answer to its offer, and the open command channel.
+ */
+type RtcBringUpStage = "signing" | "connecting" | "authenticating" | "calling" | "relay-granted" | "answered" | "connected";
 export declare class RtcSession extends EventEmitter<RtcSessionEvents> {
     private readonly opts;
     private readonly signaling;
@@ -60,8 +67,15 @@ export declare class RtcSession extends EventEmitter<RtcSessionEvents> {
     private closeAnnounced;
     private sdpHandled;
     private chain;
+    private stageReached;
+    private lastPeerState?;
     constructor(opts: RtcSessionOptions);
+    private get mediaTrack();
     get isConnected(): boolean;
+    /** The last bring-up stage this session reached. */
+    get stage(): RtcBringUpStage;
+    /** The peer connection's last reported state; `undefined` before it reports one. */
+    get peerState(): string | undefined;
     /**
      * Start the sequence; resolves once the call is sent. `connected` fires when the channel opens. A session
      * closed by the time the sign fetch or the auth completes rejects instead of opening the socket or
@@ -99,3 +113,4 @@ export declare class RtcSession extends EventEmitter<RtcSessionEvents> {
      */
     private onInfo;
 }
+export {};

package/package.json

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