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

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
@@ -604,9 +605,10 @@ export declare const CAMERA_MEMBERS: {
         timeoutMs?: number;
         skipKeyframes?: number;
     } | undefined) => Promise<Buffer<ArrayBufferLike>>)>;
-    /** The T8530 serves its live feed as a Readable too; its other media pulls stay withheld. */
+    /** The T8530 serves its live feed as a Readable too. */
     readonly openReadable: import("./members.js").ProvidedMember<"media", false | ((opts?: Parameters<NonNullable<MediaProvider["openReadable"]>>[0]) => Promise<import("node:stream").Readable>) | undefined>;
     readonly recordFragments: import("./members.js").ProvidedMember<"media", false | ((opts?: Parameters<NonNullable<MediaProvider["recordFragments"]>>[0]) => import("../../core/contracts.js").FragmentRecordingHandle) | undefined>;
+    /** A T8530 is offered the download behind a HomeBase 3 alone. */
     readonly downloadRecording: import("./members.js").ProvidedMember<"media", false | ((opts: Parameters<NonNullable<MediaProvider["downloadRecording"]>>[0]) => Promise<import("../../core/contracts.js").RecordingDownload>) | undefined>;
     /**
      * Push audio from the host to this camera's speaker. Gated on the **speaker** param specifically —

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.
      *

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/package.json

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