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

package/dist/core/contracts.d.ts

@@ -156,7 +156,7 @@ export declare class DeviceChannelUnresolvedError extends Error {
  * - `invalid-recording` — the recording name is not one the camera's station could hold.
  * - `key-unavailable` — the station stores the recording sealed and the key it was sealed under could not be
  *   obtained.
- * - `no-data` — the station sent nothing within the wait.
+ * - `no-data` — the station sent no recording: it answered that it holds none, or sent nothing within the wait.
  * - `incomplete` — the transfer ended before the station's finish frame.
  * - `undecodable` — data arrived but no video frame could be decoded from it.
  */
@@ -172,13 +172,15 @@ export declare class RecordingDownloadError extends Error {
  * A recording downloaded from the station, as elementary streams.
  *
  * `video` is Annex-B H.264 or H.265 in decode order, `audio` AAC-LC 16 kHz mono in ADTS framing (absent
- * when the recording carried none that could be decoded). `frames` counts the distinct video sequences
- * emitted. `missingFrames` counts gaps between received sequences and received sequences that yielded no
+ * when the recording carried none that could be decoded). `codec` is the codec of `video`, read off the parameter
+ * sets of its first keyframe that carries them, and is absent when no keyframe does. `frames` counts the distinct
+ * video sequences emitted. `missingFrames` counts gaps between received sequences and received sequences that yielded no
  * usable picture, including at either end. `durationMs` spans the first to the last emitted picture by the
  * camera's own timestamps; `fps` is derived from those stamps.
  */
 export interface RecordingDownload {
     video: Buffer;
+    codec?: VideoCodec;
     audio?: Buffer;
     frames: number;
     missingFrames: number;
@@ -493,7 +495,7 @@ export interface TuyaDpInbound {
      */
     onDps(sn: string, dps: Record<number, boolean | number | string>): void;
 }
-/** Elementary-stream video codec of a {@link LiveVideoFrame} — eufy cameras stream H.264 or H.265. */
+/** Elementary-stream video codec — eufy cameras stream H.264 or H.265. */
 export type VideoCodec = "h264" | "h265" | "av1";
 /**
  * One decoded video access unit, as Annex-B (H.264 or H.265).
@@ -745,9 +747,12 @@ export interface LiveStreamConsumer extends LiveStreamHandle {
 export interface AbortableCall {
     signal?: AbortSignal;
 }
-/** Select an optical view; absence selects view 0. */
+/** NVR output size requested when a live pull starts. */
+export type MediaOutputResolution = "1080p";
+/** Select an optical view and output size; absence selects view 0 at the route's default output. */
 export interface MediaSourceSelection {
     view?: number;
+    outputResolution?: MediaOutputResolution;
 }
 export interface SharedSourceHints {
     /**
@@ -774,6 +779,8 @@ export interface SharedSourceHints {
  * because an unbound model has no live client (hence `?.` at the call site).
  */
 export interface MediaProvider {
+    /** Output sizes supported by this bound media route. Absence means no size selection. */
+    outputResolutions?: readonly MediaOutputResolution[];
     /** Optical view identifiers supported by this bound media route. */
     views?: readonly number[];
     /**

package/dist/index.js

@@ -3743,6 +3743,7 @@ var isNvrT8N00 = (ctx) => ctx.model === "T8N00";
 var NVR_MEDIA_CAMERA_MODELS = /* @__PURE__ */ new Set(["T8E00", "T8P00", "T8P10", "T8162", "T8410", "T8214"]);
 var isNvrMediaCamera = (ctx) => ctx.model !== void 0 && NVR_MEDIA_CAMERA_MODELS.has(ctx.model);
 var isNvrDualLensCamera = (ctx) => ctx.model === "T8E00";
+var isNvrFullHdCamera = (ctx) => ctx.model === "T8E00" || ctx.model === "T8P00";
 var isCallDoorbell = (ctx) => ctx.model === "T8223" || ctx.model === "T8224";
 var isAiotVacuum = (ctx) => ctx.category !== "eufy_home_tuya";
 var isTuyaVacuum = (ctx) => ctx.category === "eufy_home_tuya";
@@ -6084,10 +6085,12 @@ function refuseWhenDisabled(ctx, read) {
   if (CAMERA_MEMBERS.enabled.readReflectsWrite(ctx) && read("enabled")?.value === false)
     throw new CameraDisabledError(ctx.name ?? ctx.serial);
 }
-function refuseUnsupportedView(media, opts) {
+function refuseUnsupportedSelection(media, opts) {
   const view = opts?.view ?? 0;
   if (!(media.views ?? [0]).includes(view))
     throw new RangeError(`camera: unsupported optical view ${view}`);
+  if (opts?.outputResolution !== void 0 && !media.outputResolutions?.includes(opts.outputResolution))
+    throw new RangeError(`camera: unsupported output resolution ${opts.outputResolution}`);
 }
 var CAMERA_MEMBERS = {
   /** Reads the latest cached report and exposes no setter. */
@@ -6376,6 +6379,7 @@ var CAMERA_MEMBERS = {
     write: (v, ctx) => statusLedCommand(asBool(v), ctx)
   },
   views: provided("media", (m) => m.views && (() => m.views), "Optical view identifiers supported by this camera's media route."),
+  outputResolutions: provided("media", (m) => m.outputResolutions && (() => m.outputResolutions), "Output sizes supported by this camera's live media route; omission preserves its default output."),
   /**
    * 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
@@ -6396,12 +6400,12 @@ var CAMERA_MEMBERS = {
   snapshotStored: provided("media", (m, { ctx }) => isCameraCodec(ctx) && m.snapshotStored && (() => m.snapshotStored()), "Latest validated push thumbnail retained in memory.", ["snapshot"]),
   snapshotLive: provided("media", (m, { ctx, read }) => isCameraCodec(ctx) && (async (opts) => {
     refuseWhenDisabled(ctx, read);
-    refuseUnsupportedView(m, opts);
+    refuseUnsupportedSelection(m, opts);
     return m.snapshotLive({ powered: poweredOf(ctx), ...opts });
   }), "Fresh still decoded from a short live burst."),
   live: provided("media", (m, { ctx, read }) => async (opts) => {
     refuseWhenDisabled(ctx, read);
-    refuseUnsupportedView(m, opts);
+    refuseUnsupportedSelection(m, opts);
     return m.live({ powered: poweredOf(ctx), ...opts });
   }, "Open a managed live stream."),
   record: provided("media", (m, { ctx, read }) => isCameraCodec(ctx) && (async (...args) => {
@@ -6411,7 +6415,7 @@ var CAMERA_MEMBERS = {
   /** The T8530 serves its live feed as a Readable too. */
   openReadable: provided("media", (m, { ctx, read }) => (isCameraCodec(ctx) || isVideoSmartLock(ctx)) && m.openReadable && (async (opts) => {
     refuseWhenDisabled(ctx, read);
-    refuseUnsupportedView(m, opts);
+    refuseUnsupportedSelection(m, opts);
     return m.openReadable({ powered: poweredOf(ctx), ...opts });
   }), "Open a node:stream Readable of the live feed."),
   recordFragments: provided("media", (m, { ctx, read }) => isCameraCodec(ctx) && m.recordFragments && ((opts) => {
@@ -6419,7 +6423,7 @@ var CAMERA_MEMBERS = {
     return m.recordFragments({ powered: poweredOf(ctx), ...opts });
   }), "Continuous fragmented-MP4 (CMAF) recording."),
   /** A T8530 is offered the download behind a HomeBase 3 alone. */
-  downloadRecording: provided("media", (m, { ctx }) => (isCameraCodec(ctx) || isVideoSmartLock(ctx) && ctx.stationSerial?.startsWith("T8030") === true) && m.downloadRecording && ((opts) => m.downloadRecording(opts)), "Download a recording the station holds \u2192 H.264 and AAC elementary streams."),
+  downloadRecording: provided("media", (m, { ctx }) => (isCameraCodec(ctx) || isVideoSmartLock(ctx) && ctx.stationSerial?.startsWith("T8030") === true) && m.downloadRecording && ((opts) => m.downloadRecording(opts)), "Download a recording the station holds \u2192 H.264 or H.265 and AAC elementary streams."),
   /**
    * Push audio from the host to this camera's speaker. Gated on the **speaker** param specifically —
    * not the `audio` capability, which resolves on a microphone alone and would advertise a speaker the
@@ -20058,7 +20062,16 @@ function homeBase3RecordingPath(channel, recording) {
 }
 var RECORDING_STATIONS = /* @__PURE__ */ new Map([
   ["T8010", { path: homeBase2RecordingPath, sealed: true, finishChannel: 0, chunkBytes: STATION_CHUNK_BYTES }],
-  ["T8030", { path: homeBase3RecordingPath, sealed: false, finishChannel: STATION_CHANNEL3, chunkBytes: 4e5 }]
+  [
+    "T8030",
+    {
+      path: homeBase3RecordingPath,
+      sealed: false,
+      finishChannel: STATION_CHANNEL3,
+      chunkBytes: 4e5,
+      missingCode: -111
+    }
+  ]
 ]);
 function receiveRecording(session, request) {
   let resolveFrames;
@@ -20102,6 +20115,14 @@ function receiveRecording(session, request) {
     collected = [];
   };
   const onData = (frame) => {
+    if (frame.commandId === CommandType.CMD_DOWNLOAD_VIDEO) {
+      if (frame.channel !== request.channel || frame.dataType !== 0 || received || draining)
+        return;
+      if (frame.data.length < 4 || frame.data.readInt32LE(0) !== request.missingCode)
+        return;
+      deliver(new RecordingDownloadError("no-data", `the station holds no recording at ${request.path}`));
+      return stop();
+    }
     if (frame.commandId === CommandType.CMD_DOWNLOAD_FINISH) {
       if (frame.channel !== request.channel && frame.channel !== request.finishChannel)
         return;
@@ -20172,6 +20193,7 @@ function decodeRecording(frames, station, eccPrivateKeyHex) {
   const decoder = eccPrivateKey && new VideoFrameDecoder(eccPrivateKey);
   const assembler = new AccessUnitAssembler(void 0, station.chunkBytes);
   const video = [];
+  let codec;
   const audio = [];
   const numbers = /* @__PURE__ */ new Set();
   const receivedNumbers = /* @__PURE__ */ new Set();
@@ -20186,6 +20208,8 @@ function decodeRecording(frames, station, eccPrivateKeyHex) {
       const units = assembler.push(raw, (payload) => decoder && header.keyframe ? decoder.decodeFrame(payload)?.h264 : clearVideoPayload(payload, header));
       for (const unit of units) {
         video.push(unit.data);
+        if (unit.keyframe)
+          codec ??= sniffAnnexbCodec(unit.data);
         numbers.add(header.sequence);
         const stamp = raw.readUIntLE(14, 6);
         firstStamp ??= stamp;
@@ -20214,6 +20238,7 @@ function decodeRecording(frames, station, eccPrivateKeyHex) {
   const durationMs = (lastStamp ?? 0) - (firstStamp ?? 0);
   return {
     video: Buffer.concat(video),
+    ...codec ? { codec } : {},
     ...audio.length ? { audio: Buffer.concat(audio) } : {},
     frames: ordered.length,
     missingFrames,
@@ -23028,6 +23053,7 @@ var P2PCommandRouter = class _P2PCommandRouter {
       accountId,
       channel,
       finishChannel: station.finishChannel,
+      missingCode: station.missingCode,
       timeoutMs: opts.timeoutMs,
       signal: opts.signal
     });
@@ -24478,6 +24504,7 @@ var RtcLiveStream = class extends EventEmitter7 {
           audio_chn: nvr ? this.opts.channel : -1,
           streamtype: 2,
           stitch_mode: 1,
+          ...this.opts.outputResolution === "1080p" ? { stitch_resolution: { width: 1920, height: 1080 } } : {},
           chn_list: [{ index: 0, chn: this.opts.channel, sensor: this.opts.view ?? 0, isUps: 0, isClicked: true }],
           pip_cord: { x1: 0, y1: 0, x2: 0, y2: 0 },
           station_video_type: 6,
@@ -25518,13 +25545,14 @@ var RtcSession = class extends EventEmitter11 {
   closeAnnounced = false;
   sdpHandled = false;
   chain = Promise.resolve();
+  stageReached = "signing";
+  lastPeerState;
   constructor(opts) {
     super();
     this.opts = opts;
     this.logger = opts.logger ?? noopLogger;
     this.signaling = (opts.createSignaling ?? ((o) => new RtcSignalingClient(o)))(opts);
     this.peer = (opts.createPeer ?? ((o) => new RtcPeer(o)))({ logger: this.logger, ...opts.peer });
-    const mediaTrack = opts.peer?.mediaTrack === true;
     this.signaling.on("message", (inner) => {
       this.chain = this.chain.then(() => this.onSignaling(inner)).catch((e) => {
         this.emit("error", e instanceof Error ? e : new Error(String(e)));
@@ -25538,6 +25566,7 @@ var RtcSession = class extends EventEmitter11 {
       if (this.connected)
         return;
       this.connected = true;
+      this.stageReached = "connected";
       this.logger.debug(`[rtc] ${this.opts.stationSn} command channel open`);
       this.emit("connected");
     });
@@ -25549,9 +25578,14 @@ var RtcSession = class extends EventEmitter11 {
       this.announceClose();
     });
     this.peer.on("connectionState", (state) => {
-      if ((state === "failed" || state === "closed") && (this.connected || mediaTrack)) {
+      this.lastPeerState = state;
+      if (state !== "failed" && state !== "closed")
+        return;
+      if (this.connected || this.mediaTrack) {
         this.connected = false;
         this.announceClose();
+      } else {
+        this.shutdown(new Error(`RTC ${this.opts.stationSn} peer ${state} before the command channel opened`));
       }
     });
     this.peer.on("error", (e) => this.emit("error", e));
@@ -25564,9 +25598,20 @@ var RtcSession = class extends EventEmitter11 {
         this.emit("commandData", frame, linkType);
     });
   }
+  get mediaTrack() {
+    return this.opts.peer?.mediaTrack === true;
+  }
   get isConnected() {
     return this.connected;
   }
+  /** The last bring-up stage this session reached. */
+  get stage() {
+    return this.stageReached;
+  }
+  /** The peer connection's last reported state; `undefined` before it reports one. */
+  get peerState() {
+    return this.lastPeerState;
+  }
   /**
    * 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
@@ -25576,11 +25621,14 @@ var RtcSession = class extends EventEmitter11 {
     await this.signaling.fetchSign();
     if (this.closed)
       throw new Error("RTC session closed before the call was placed");
+    this.stageReached = "connecting";
     await this.signaling.connect();
+    this.stageReached = "authenticating";
     await this.waitForAuth();
     if (this.closed)
       throw new Error("RTC session closed before the call was placed");
     this.logger.debug(`[rtc] ${this.opts.stationSn} authenticated \u2014 ${this.opts.signalingMode ?? "scall"}`);
+    this.stageReached = "calling";
     this.signaling.sendCall();
   }
   /** Send one portal packet; false when the command channel isn't open. */
@@ -25676,6 +25724,9 @@ var RtcSession = class extends EventEmitter11 {
         return;
       case "hangup":
         this.logger.debug(`[rtc] ${this.opts.stationSn} hub hung up`);
+        if (!this.connected && this.opts.signalingMode !== "call") {
+          this.shutdown(new Error(`RTC ${this.opts.stationSn} hub hung up before the command channel opened`));
+        }
         return;
       default:
         return;
@@ -25688,6 +25739,7 @@ var RtcSession = class extends EventEmitter11 {
     const status = payload.status;
     if (status === 100 && payload.turn) {
       this.turn = payload.turn;
+      this.stageReached = "relay-granted";
       try {
         await this.peer.init(payload.turn);
       } catch (e) {
@@ -25743,6 +25795,7 @@ var RtcSession = class extends EventEmitter11 {
     }
     const answer = await this.peer.handleRemoteOffer(offer);
     this.signaling.sendInfoSdp(this.opts.signalingMode === "call" ? answer : JSON.stringify(sdpToScallJson(answer)));
+    this.stageReached = "answered";
     this.logger.debug(`[rtc] ${this.opts.stationSn} answered the hub's offer`);
   }
 };
@@ -25879,9 +25932,9 @@ var RtcCommandRouter = class {
     return this.callMediaProviderFor(route, route.stationSn, (session) => new RtcCallLiveStream(session, this.deps.logger), `record is not available for ${route.stationSn} over a portal call`, 45e3);
   }
   /** NVR media uses a dedicated call per camera, independent of station commands. */
-  nvrMediaProviderFor(route, views) {
+  nvrMediaProviderFor(route, views, outputResolutions) {
     return {
-      ...this.callMediaProviderFor(route, route.cameraSn, (session, accountId, view) => new RtcLiveStream({
+      ...this.callMediaProviderFor(route, route.cameraSn, (session, accountId, view, outputResolution) => new RtcLiveStream({
         session,
         seg: new SegmentCounter(),
         stationSn: route.stationSn,
@@ -25889,9 +25942,11 @@ var RtcCommandRouter = class {
         accountId,
         logger: this.deps.logger,
         nvr: true,
-        view
+        view,
+        outputResolution
       }), "record is not available over an NVR portal call"),
-      views
+      views,
+      outputResolutions
     };
   }
   /**
@@ -25905,7 +25960,8 @@ var RtcCommandRouter = class {
     const sourceFor = (opts = {}) => {
       opts.signal?.throwIfAborted();
       const view = opts.view ?? 0;
-      const sourceKey = view === 0 ? key : `${key}:view:${view}`;
+      const viewKey = view === 0 ? key : `${key}:view:${view}`;
+      const sourceKey = opts.outputResolution ? `${viewKey}:output:${opts.outputResolution}` : viewKey;
       let source = this.callSources.get(sourceKey);
       if (!source) {
         source = new SharedLiveSource({
@@ -25914,7 +25970,7 @@ var RtcCommandRouter = class {
             if (!identity)
               throw new Error(`rtc: not logged in, cannot call ${route.stationSn}`);
             const accountId = route.adminUserId || identity.userId;
-            return makeStream(this.newSession(route, accountId, identity, this.callShards.get(key)), accountId, view);
+            return makeStream(this.newSession(route, accountId, identity, this.callShards.get(key)), accountId, view, opts.outputResolution);
           },
           label: sourceKey,
           logger: this.deps.logger,
@@ -26218,7 +26274,8 @@ var RtcCommandRouter = class {
   /**
    * 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.
    */
   bringUp(sn, session) {
@@ -26244,7 +26301,7 @@ var RtcCommandRouter = class {
       };
       const onConnected = () => finish();
       const onClose = (err) => finish(err ?? new Error(`rtc: ${sn} session closed before the command channel opened`));
-      const timer = setTimeout(() => finish(new Error(`rtc: ${sn} did not come up within ${CONNECT_TIMEOUT_MS2}ms`)), CONNECT_TIMEOUT_MS2);
+      const timer = setTimeout(() => finish(new Error(`rtc: ${sn} did not come up within ${CONNECT_TIMEOUT_MS2}ms (stage ${session.stage}, peer ${session.peerState ?? "not started"})`)), CONNECT_TIMEOUT_MS2);
       session.once("connected", onConnected);
       session.once("close", onClose);
       Promise.resolve().then(() => session.connect()).catch((e) => finish(e instanceof Error ? e : new Error(String(e))));
@@ -30765,7 +30822,7 @@ var EufyMega = class _EufyMega extends EventEmitter14 {
     if (route.signalingMode === "call") {
       if (!camera || !isNvrMediaCamera(camera))
         return void 0;
-      return this.rtc.nvrMediaProviderFor({ ...route, cameraSn: sn, channel }, isNvrDualLensCamera(camera) ? [0, 1] : [0]);
+      return this.rtc.nvrMediaProviderFor({ ...route, cameraSn: sn, channel }, isNvrDualLensCamera(camera) ? [0, 1] : [0], isNvrFullHdCamera(camera) ? ["1080p"] : void 0);
     }
     return this.rtc.mediaProviderFor({ ...route, cameraSn: sn, channel });
   }