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

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) => {
@@ -6977,6 +6987,28 @@ var PTZ = {
 
 // dist/model/capabilities/doorbell.js
 import { setTimeout as sleep } from "node:timers/promises";
+var DOORBELL_MODELS = /* @__PURE__ */ new Set([
+  "T820",
+  "T8200",
+  "T8201",
+  "T8202",
+  "T8203",
+  "T8210",
+  "T8212",
+  "T8213",
+  "T8214",
+  "T8220",
+  "T8221",
+  "T8222"
+]);
+var DOORBELL_TYPES = [
+  DeviceType.DOORBELL,
+  DeviceType.BATTERY_DOORBELL,
+  DeviceType.BATTERY_DOORBELL_2,
+  DeviceType.BATTERY_DOORBELL_PLUS,
+  DeviceType.DOORBELL_SOLO,
+  DeviceType.BATTERY_DOORBELL_PLUS_E340
+];
 var DOORBELL_CMD = {
   /**
    * Doorbell "quick response" — make the doorbell PLAY a stored voice reply. Same 136-byte
@@ -7313,8 +7345,16 @@ var DOORBELL = {
   description: "Doorbell chime / ringtone configuration (ring press is an event, not a param).",
   members: DOORBELL_MEMBERS,
   properties: propertiesOf(DOORBELL_MEMBERS),
-  /** Doorbells self-report no single unambiguous param; the model name is the reliable signal. */
-  detection: { modelHints: [/doorbell/i] },
+  /**
+   * Doorbells self-report no param of their own (the 1702-1719 settings also arrive from eufyCams), and
+   * the cloud record names no product, so detection keys off the app's own tables:
+   * {@link DOORBELL_MODELS} and {@link DOORBELL_TYPES}.
+   */
+  detection: {
+    detect: (rec) => DOORBELL_MODELS.has(rec.model ?? ""),
+    deviceTypes: DOORBELL_TYPES,
+    modelHints: [/doorbell/i]
+  },
   /**
    * Inbound FCM doorbell events (`DoorbellPushEvent`): ring press and the package trio.
    *
@@ -11584,18 +11624,16 @@ var MODEL_REGISTRY = {
   T8002: { codec: "station", name: "HomeBase E" },
   // Cameras with curated extras that aren't always provable from a fresh device's params.
   T8423: { codec: "camera", caps: ["light", "battery"], name: "Floodlight Cam" },
-  T8210: { codec: "camera", caps: ["doorbell", "battery"], name: "Video Doorbell" },
+  T8210: { codec: "camera", caps: ["battery"], name: "Video Doorbell" },
   // T8210 hardware variant, reported as its own code; shares the T8210 row.
-  T8210C: { codec: "camera", caps: ["doorbell", "battery"], name: "Video Doorbell" },
+  T8210C: { codec: "camera", caps: ["battery"], name: "Video Doorbell" },
   // Confirmed against a real owned unit (named "Doorbell"): Video Doorbell Dual.
-  T8214: { codec: "camera", caps: ["doorbell", "battery"], name: "Video Doorbell Dual" },
-  // Battery Video Doorbell Dual, vendor deviceType 91 (BATTERY_DOORBELL_PLUS), reported by two users.
-  T8213: { codec: "camera", caps: ["doorbell", "battery"], name: "Video Doorbell Dual" },
+  T8214: { codec: "camera", caps: ["battery"], name: "Video Doorbell Dual" },
+  T8213: { codec: "camera", caps: ["battery"], name: "Video Doorbell Dual" },
   // Confirmed against a real owned unit: the mains-powered Wired Doorbell 2K. No `battery` row
   // member on purpose — this model is wired, so the codec baseline plus inference is the whole
-  // truth for power. Without this row it classified as a plain camera, so the doorbell capability
-  // never appeared and consumers got no doorbell event entity or ring trigger.
-  T8200: { codec: "camera", caps: ["doorbell"], name: "Wired Doorbell 2K" },
+  // truth for power.
+  T8200: { codec: "camera", name: "Wired Doorbell 2K" },
   // Cameras observed on real owned hardware (inspect-device sweep). Names from the app's own
   // model-family constants (scripts/data/app_model_registry.json); caps mirror what the device
   // reports. T8171 has no family entry in that dump, so it keeps the raw T-code.
@@ -23501,7 +23539,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 +24881,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 +24910,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 +29491,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 +29580,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 });
   }