@mega-yfue/eufy-sdk 0.5.0-beta.77 → 0.5.0-beta.78

package/dist/core/contracts.d.ts

@@ -734,6 +734,10 @@ export interface LiveStreamConsumer extends LiveStreamHandle {
 export interface AbortableCall {
     signal?: AbortSignal;
 }
+/** Select an optical view; absence selects view 0. */
+export interface MediaSourceSelection {
+    view?: number;
+}
 export interface SharedSourceHints {
     /**
      * Power source, a runtime device fact (`"battery"` incl. solar, or `"wired"`) — never a device-family
@@ -759,6 +763,8 @@ export interface SharedSourceHints {
  * because an unbound model has no live client (hence `?.` at the call site).
  */
 export interface MediaProvider {
+    /** Optical view identifiers supported by this bound media route. */
+    views?: readonly number[];
     /**
      * Return the latest validated push thumbnail retained in memory. This passive operation performs no
      * network, storage, P2P, live-media, or transcoding work at call time. It rejects with
@@ -785,7 +791,7 @@ export interface MediaProvider {
         timeoutMs?: number;
         collectMs?: number;
         skipKeyframes?: number;
-    } & SharedSourceHints & AbortableCall): Promise<{
+    } & SharedSourceHints & AbortableCall & MediaSourceSelection): Promise<{
         jpeg: Buffer;
         width: number;
         height: number;
@@ -817,7 +823,7 @@ export interface MediaProvider {
      * stream?.stop(); // detach this consumer
      * ```
      */
-    live(opts?: SharedSourceHints & AbortableCall & Record<string, unknown>): Promise<LiveStreamConsumer>;
+    live(opts?: SharedSourceHints & AbortableCall & MediaSourceSelection & Record<string, unknown>): Promise<LiveStreamConsumer>;
     /**
      * Record `seconds` of video → an mp4/h264 buffer.
      *
@@ -843,7 +849,7 @@ export interface MediaProvider {
     openReadable?(opts?: {
         objectMode?: boolean;
         arrivalTime?: boolean;
-    } & SharedSourceHints & AbortableCall): Promise<import("node:stream").Readable>;
+    } & SharedSourceHints & AbortableCall & MediaSourceSelection): Promise<import("node:stream").Readable>;
     /**
      * Continuously record the live feed as fragmented-MP4 (CMAF). The caller-owned
      * {@link FragmentRecordingHandle} yields an init segment then keyframe-bounded media fragments,

package/dist/index.js

@@ -3656,6 +3656,7 @@ var isHomeBase = (ctx) => has(HOMEBASE_TYPES, ctx.deviceType);
 var isStation9000 = (ctx) => ctx.deviceType === DeviceType.STATION_9000;
 var isNvrT8N00 = (ctx) => ctx.model === "T8N00";
 var isNvrMediaCamera = (ctx) => ctx.model === "T8E00" || ctx.model === "T8P00";
+var isNvrDualLensCamera = (ctx) => ctx.model === "T8E00";
 var isDoorbellT8223 = (ctx) => ctx.model === "T8223";
 var isAiotVacuum = (ctx) => ctx.category !== "eufy_home_tuya";
 var isTuyaVacuum = (ctx) => ctx.category === "eufy_home_tuya";
@@ -5591,6 +5592,11 @@ 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) {
+  const view = opts?.view ?? 0;
+  if (!(media.views ?? [0]).includes(view))
+    throw new RangeError(`camera: unsupported optical view ${view}`);
+}
 var CAMERA_MEMBERS = {
   /** Reads the latest cached report and exposes no setter. */
   wifiRssi: {
@@ -5861,6 +5867,7 @@ var CAMERA_MEMBERS = {
     description: "Camera status LED. Video doorbells report the same state under their button-ring LED parameter.",
     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."),
   /**
    * 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
@@ -5881,10 +5888,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);
     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);
     return m.live({ powered: poweredOf(ctx), ...opts });
   }, "Open a managed live stream."),
   record: provided("media", (m, { ctx, read }) => isCameraCodec(ctx) && (async (...args) => {
@@ -5893,6 +5902,7 @@ var CAMERA_MEMBERS = {
   }), "Record N seconds \u2192 an mp4/h264 buffer."),
   openReadable: provided("media", (m, { ctx, read }) => isCameraCodec(ctx) && m.openReadable && (async (opts) => {
     refuseWhenDisabled(ctx, read);
+    refuseUnsupportedView(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) => {
@@ -23501,7 +23511,7 @@ var RtcLiveStream = class extends EventEmitter7 {
           audio_chn: nvr ? this.opts.channel : -1,
           streamtype: 2,
           stitch_mode: 1,
-          chn_list: [{ index: 0, chn: this.opts.channel, sensor: 0, isUps: 0, isClicked: true }],
+          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,
           play_id: 1
@@ -24843,22 +24853,28 @@ 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) {
-    return this.callMediaProviderFor(route, route.cameraSn, (session, accountId) => new RtcLiveStream({
-      session,
-      seg: new SegmentCounter(),
-      stationSn: route.stationSn,
-      channel: route.channel,
-      accountId,
-      logger: this.deps.logger,
-      nvr: true
-    }), "record is not available over an NVR portal call");
+  nvrMediaProviderFor(route, views) {
+    return {
+      ...this.callMediaProviderFor(route, route.cameraSn, (session, accountId, view) => new RtcLiveStream({
+        session,
+        seg: new SegmentCounter(),
+        stationSn: route.stationSn,
+        channel: route.channel,
+        accountId,
+        logger: this.deps.logger,
+        nvr: true,
+        view
+      }), "record is not available over an NVR portal call"),
+      views
+    };
   }
   /** Share a dedicated-call source and its consumer operations under one route key. */
   callMediaProviderFor(route, key, makeStream, recordError, warmTimeoutMs) {
     const sourceFor = (opts = {}) => {
       opts.signal?.throwIfAborted();
-      let source = this.callSources.get(key);
+      const view = opts.view ?? 0;
+      const sourceKey = view === 0 ? key : `${key}:view:${view}`;
+      let source = this.callSources.get(sourceKey);
       if (!source) {
         source = new SharedLiveSource({
           makeStream: () => {
@@ -24866,15 +24882,15 @@ 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), accountId);
+            return makeStream(this.newSession(route, accountId, identity), accountId, view);
           },
-          label: key,
+          label: sourceKey,
           logger: this.deps.logger,
           powered: opts.powered,
           preBufferSeconds: opts.preBufferSeconds,
           warmTimeoutMs
         });
-        this.callSources.set(key, source);
+        this.callSources.set(sourceKey, source);
       }
       return source;
     };
@@ -29447,7 +29463,7 @@ var EufyMega = class extends EventEmitter14 {
         try {
           return await media.snapshotLive(opts);
         } catch (error) {
-          if (!(error instanceof LiveSnapshotUnavailableError))
+          if (!(error instanceof LiveSnapshotUnavailableError) || (opts?.view ?? 0) !== 0)
             throw error;
           const retained = await retainedStill().catch(() => void 0);
           const geometry = retained && jpegGeometry(retained);
@@ -29536,7 +29552,7 @@ var EufyMega = class extends EventEmitter14 {
     if (route.signalingMode === "call") {
       if (!camera || !isNvrMediaCamera(camera))
         return void 0;
-      return this.rtc.nvrMediaProviderFor({ ...route, cameraSn: sn, channel });
+      return this.rtc.nvrMediaProviderFor({ ...route, cameraSn: sn, channel }, isNvrDualLensCamera(camera) ? [0, 1] : [0]);
     }
     return this.rtc.mediaProviderFor({ ...route, cameraSn: sn, channel });
   }