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

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,29 +6400,30 @@ 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) => {
     refuseWhenDisabled(ctx, read);
     return m.record(...args);
   }), "Record N seconds \u2192 an mp4/h264 buffer."),
-  /** 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. */
   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) => {
     refuseWhenDisabled(ctx, read);
     return m.recordFragments({ powered: poweredOf(ctx), ...opts });
   }), "Continuous fragmented-MP4 (CMAF) recording."),
-  downloadRecording: provided("media", (m, { ctx }) => isCameraCodec(ctx) && m.downloadRecording && ((opts) => m.downloadRecording(opts)), "Download a recording the station holds \u2192 H.264 and AAC elementary streams."),
+  /** 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 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
@@ -20057,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;
@@ -20101,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;
@@ -20171,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();
@@ -20185,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;
@@ -20213,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,
@@ -23027,6 +23053,7 @@ var P2PCommandRouter = class _P2PCommandRouter {
       accountId,
       channel,
       finishChannel: station.finishChannel,
+      missingCode: station.missingCode,
       timeoutMs: opts.timeoutMs,
       signal: opts.signal
     });
@@ -24477,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,
@@ -25878,9 +25906,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,
@@ -25888,9 +25916,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
     };
   }
   /**
@@ -25904,7 +25934,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({
@@ -25913,7 +25944,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,
@@ -30764,7 +30795,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 });
   }