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

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

@@ -575,6 +575,7 @@ export declare const CAMERA_MEMBERS: {
         readonly write: (v: string | number | boolean, ctx: CommandContext) => Command;
     };
     readonly views: import("./members.js").ProvidedMember<"media", (() => readonly number[]) | undefined>;
+    readonly outputResolutions: import("./members.js").ProvidedMember<"media", (() => readonly "1080p"[]) | undefined>;
     /**
      * Media is not a property: it returns DATA rather than moving state, its options are richer than a
      * value, and it exists only on a device bound to a provider. Each is declared once, with its

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

@@ -56,6 +56,8 @@ export declare const isNvrT8N00: (ctx: FamilyContext) => boolean;
 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;
+/** NVR cameras verified to support an explicit 1080p live output. */
+export declare const isNvrFullHdCamera: (ctx: FamilyContext) => boolean;
 /** Video Doorbell C31 (T8223) or C30 (T8224), streamed by the app over the portal `call` route. */
 export declare const isCallDoorbell: (ctx: FamilyContext) => boolean;
 /** Wired doorbell (DeviceType.DOORBELL). */

package/dist/transport/p2p/recording-download.d.ts

@@ -68,6 +68,11 @@ export interface RecordingStation {
      * ({@link AccessUnitAssembler}).
      */
     readonly chunkBytes: number;
+    /**
+     * The result code that opens the station's `CMD_DOWNLOAD_VIDEO` reply on the camera's channel when it holds no
+     * recording at the path, after which it sends nothing. Absent on a station whose reply is unconfirmed.
+     */
+    readonly missingCode?: number;
 }
 /**
  * The path a HomeBase 2 stores a camera's recording under: its {@link cameraFolder}, then the recording's name
@@ -91,7 +96,8 @@ export declare function homeBase3RecordingPath(channel: number, recording: strin
  * with channel 0, split pictures filled to {@link STATION_CHUNK_BYTES}.
  *
  * `T8030`, HomeBase 3: `/zx/emmcdata/CameraNN/<yyyyMM>/<name>/<name>.zxvideo`, in the clear, finish tagged
- * with {@link STATION_CHANNEL}, a keyframe over 400000 bytes split at exactly 400000.
+ * with {@link STATION_CHANNEL}, a keyframe over 400000 bytes split at exactly 400000, a missing recording
+ * answered with -111.
  */
 export declare const RECORDING_STATIONS: ReadonlyMap<string, RecordingStation>;
 /** One recording transfer on a station session. */
@@ -107,7 +113,9 @@ export interface RecordingTransfer {
  * station is never mixed in. The finish frame is taken on the camera's channel or on `finishChannel`
  * ({@link RecordingStation.finishChannel}).
  *
- * `frames` rejects with {@link RecordingDownloadError}: `no-data` when nothing arrives within
+ * `frames` rejects with {@link RecordingDownloadError}: `no-data` when the station's reply on the camera's
+ * channel carries `missingCode` ({@link RecordingStation.missingCode}) before any of the recording's frames, which
+ * also ends the transfer, or when nothing arrives within
  * {@link FIRST_FRAME_WAIT_MS}, and `incomplete` when the transfer ends without its finish frame, on a
  * {@link IDLE_END_MS} silence, on `timeoutMs` or on {@link MAX_TRANSFER_BYTES}. An abort rejects it at once
  * with the signal's reason. After a time bound, the byte ceiling or an abort, the transfer stops collecting
@@ -118,6 +126,7 @@ export declare function receiveRecording(session: P2PSession, request: {
     accountId: string;
     channel: number;
     finishChannel: number;
+    missingCode?: number;
     timeoutMs?: number;
     signal?: AbortSignal;
 }): RecordingTransfer;

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

@@ -23,7 +23,7 @@
  * through one shared live source per station: the station serves one camera at a time, so a second
  * camera is refused until the first one's view ends.
  */
-import { type Command, type MediaProvider } from "../../core/contracts.js";
+import { type Command, type MediaOutputResolution, type MediaProvider } from "../../core/contracts.js";
 import type { Logger } from "../../core/logger.js";
 import { RtcSession, type RtcSessionOptions } from "./session.js";
 export interface RtcIdentity {
@@ -133,7 +133,7 @@ export declare class RtcCommandRouter {
      */
     trackMediaProviderFor(route: RtcRoute): MediaProvider;
     /** NVR media uses a dedicated call per camera, independent of station commands. */
-    nvrMediaProviderFor(route: RtcLiveRoute, views: readonly number[]): MediaProvider;
+    nvrMediaProviderFor(route: RtcLiveRoute, views: readonly number[], outputResolutions?: readonly MediaOutputResolution[]): MediaProvider;
     /**
      * Share a dedicated-call source and its consumer operations under one route key.
      *
@@ -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/live.d.ts

@@ -6,6 +6,7 @@
  *  - Start is inner `cmd 1003` in a `1350` SET_PAYLOAD on the station channel `255`. The header byte the
  *    codec names `isResponse` carries the portal's `streamId`, `1` for a live view, and `chn_list` is an
  *    array of `{index, chn, sensor, isUps, isClicked}` objects. Stop is inner `cmd 1004`, the same way.
+ *  - The NVR start may carry `stitch_resolution: {width, height}` to set output geometry; omission keeps the NVR default.
  *  - Video arrives on the live link as portal packets `1300` on channel `100 + play id`; a single-camera
  *    view is play id `1`, whatever the camera's own channel. Each body is a fixed 22-byte media header,
  *    then the Annex B video it declares. See {@link parseMediaBody}.
@@ -17,7 +18,7 @@
  * shared live source's.
  */
 import { EventEmitter } from "node:events";
-import type { LiveStreamHandle } from "../../core/contracts.js";
+import type { LiveStreamHandle, MediaOutputResolution } from "../../core/contracts.js";
 import type { Logger } from "../../core/logger.js";
 import type { RtcSession } from "./session.js";
 import { type SegmentCounter } from "./portal-packet.js";
@@ -46,6 +47,8 @@ export interface RtcLiveOptions {
     nvr?: boolean;
     /** Optical view carried by the NVR start request; defaults to 0. */
     view?: number;
+    /** NVR live-start output geometry; absence sends no size override. */
+    outputResolution?: MediaOutputResolution;
 }
 /**
  * One camera's live pull. `start()` sends the start; a non-zero start ACK or a closed session ends it with

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.34",
+  "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",