@mega-yfue/eufy-sdk 0.5.0-beta.73 → 0.5.0-beta.75

package/dist/client/eufy-mega.d.ts

@@ -456,8 +456,7 @@ export declare class EufyMega extends EventEmitter {
     private rtcRouteFor;
     /**
      * The RTC media provider for a station on a media-track route, or a camera attached to a T9000 whose
-     * `device_channel` resolves back to it on the station; `undefined` otherwise, including a camera behind
-     * a T8N00, whose route carries commands only.
+     * `device_channel` resolves back to it on the station; `undefined` otherwise, unless an NVR camera has its own dedicated media call.
      */
     private rtcMediaFor;
     /**

package/dist/index.js

@@ -3655,6 +3655,7 @@ var isIndoorPanTiltS350 = (ctx) => has(INDOOR_PT_S350_TYPES, ctx.deviceType);
 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 isDoorbellT8223 = (ctx) => ctx.model === "T8223";
 var isAiotVacuum = (ctx) => ctx.category !== "eufy_home_tuya";
 var isTuyaVacuum = (ctx) => ctx.category === "eufy_home_tuya";
@@ -5618,6 +5619,7 @@ var CAMERA_MEMBERS = {
     type: "bool",
     kind: "boolean",
     provenance: "verified",
+    available: isCameraCodec,
     invert: true,
     invertFor: (ctx) => isT8410HomeBase3(ctx) ? false : void 0,
     readAliases: [{ paramType: 2001, invert: false }],
@@ -5642,6 +5644,7 @@ var CAMERA_MEMBERS = {
     type: "bool",
     kind: "boolean",
     provenance: "apk",
+    available: isCameraCodec,
     description: "Rotate the image 180\xB0 (ROTATE_IMAGE 1207): false = normal, true = flipped. For ceiling/upside-down mounts. Write is a direct param; wire from the app parser (unverified live).",
     write: (v, ctx) => setScalar(CAMERA_CMD.ROTATE_IMAGE, asBool(v) ? 1 : 0, ctx, "auto")
   },
@@ -5657,6 +5660,7 @@ var CAMERA_MEMBERS = {
     kind: "enum",
     enumValues: { 0: "Off", 1: "Timestamp", 2: "Timestamp + Logo" },
     provenance: "verified",
+    available: isCameraCodec,
     description: "On-screen watermark/OSD overlay (CMD_SET_DEVS_OSD 1214). \u2705 wire verified live (T8425 ch3): direct-binary [ch][value 0/1/2] \u2014 a 3-value enum, not a bool. Enum labels are best-guess.",
     write: (v, ctx) => {
       const w = coerceEnumValue(Watermark, v);
@@ -5673,6 +5677,7 @@ var CAMERA_MEMBERS = {
     type: "bool",
     kind: "boolean",
     provenance: "verified",
+    available: isCameraCodec,
     description: "Trigger on sound as well as motion (SOUND_DETECTION 6043). \u2705 Write confirmed live on a T8410 (mains, standalone, own channel): both directions sent through this member and read back on the cloud param, and the app's own frame captured byte-exact for the same body.",
     write: (v, ctx) => setJson(CAMERA_CMD.SOUND_DETECTION, { status: asBool(v) ? 1 : 0 }, ctx)
   },
@@ -5688,6 +5693,7 @@ var CAMERA_MEMBERS = {
     type: "number",
     kind: "scalar",
     provenance: "verified",
+    available: isCameraCodec,
     description: "Sound-detection sensitivity: 1 = lowest, 3 = mid, 5 = highest (SOUND_DETECTION_SENSITIVITY 6044). \u2705 Write confirmed live on a T8410: 1 and 5 sent consecutively through this member and read back on the cloud param. 2 and 4 are the scale's shape, not observed values.",
     write: (v, ctx) => {
       const n = Number(v);
@@ -5707,6 +5713,7 @@ var CAMERA_MEMBERS = {
     kind: "enum",
     enumValues: { 1: "Crying", 2: "All Sound" },
     provenance: "verified",
+    available: isCameraCodec,
     description: "Which sounds trigger a detection: crying alone, or any sound (SOUND_DETECTION_TYPE 6046). \u2705 Write confirmed live on a T8410: both values sent consecutively through this member and read back on the cloud param.",
     write: (v, ctx) => {
       const type = coerceEnumValue(SoundDetectionType, v);
@@ -5727,6 +5734,7 @@ var CAMERA_MEMBERS = {
     kind: "enum",
     enumValues: { 1: "Text Only", 2: "Included Thumbnail", 3: "Text First, Then Thumbnail" },
     provenance: "verified",
+    available: isCameraCodec,
     description: "How much a detection push carries: text only, a thumbnail, or text then a thumbnail (CMD_INDOOR_PUSH_NOTIFY_TYPE 6020). All three values wire-verified live on a standalone T8171 over the cloud/WAN path \u2014 the 1700 control-payload wrapper, each one read back on the cloud param. A value outside the enum is REJECTED, not clamped: every neighbouring value is a real style, so a bad one would silently select the wrong notification.",
     write: (v, ctx) => {
       const style = coerceEnumValue(NotificationStyle2, v);
@@ -5745,6 +5753,7 @@ var CAMERA_MEMBERS = {
     kind: "enum",
     enumValues: { 0: "Off", 1: "Infrared", 2: "Full Color" },
     provenance: "verified",
+    available: isCameraCodec,
     description: "Night-vision mode (NIGHT_VISION_TYPE 1277): 0 = off, 1 = infrared (B&W), 2 = full colour. \u2705 wire verified live (T8425 ch3): 1350 SET_PAYLOAD, mChannel 0, {channel:N, night_sion:mode}. Enum labels are best-guess. Some models omit full colour.",
     write: (v, ctx) => {
       const nv = coerceEnumValue(NightVision, v);
@@ -5770,6 +5779,7 @@ var CAMERA_MEMBERS = {
     kind: "enum",
     enumValues: STREAMING_QUALITY_TIERS,
     provenance: "verified",
+    available: isCameraCodec,
     args: [{ name: "quality", kind: "enum", description: "A tier, or the name it maps to. 0 is Auto." }],
     ...accepts(),
     description: "Live-view quality as a tier, 0 = Auto (1020; the write rides 2730 APP_CMD_MULTI_CAM_SET_VIDEO_QUALITY). Distinct from recordingQuality, which is what gets stored. All four tiers wire-verified live on a T8170 and read back on 1020. Sent from this SDK to a standalone T8170 and T8171, tier 1 holds the live stream at 1280x720 and tier 0 restores the camera's own resolution ladder \u2014 see CAMERA_CMD.STREAMING_QUALITY_SET. A value outside the tier set is REJECTED, not clamped: every tier in range is a real quality, so a bad one would silently pick another.",
@@ -5787,6 +5797,7 @@ var CAMERA_MEMBERS = {
     param: CAMERA_CMD.RECORDING_QUALITY_SET,
     type: "string",
     provenance: "verified",
+    available: isCameraCodec,
     decode: (raw) => decodeRecordingQualityTier(raw),
     decodedKind: "enum",
     decodedValues: Object.keys(RECORDING_QUALITY_TIERS).map(Number),
@@ -5811,6 +5822,7 @@ var CAMERA_MEMBERS = {
     type: "bool",
     kind: "boolean",
     provenance: "apk",
+    available: isCameraCodec,
     description: "Anti-theft detection on/off (1015 APP_CMD_EAS_SWITCH; the app parses it as anti_theft_detection_switch). Adaptive scalar {value:0|1}. \u26A0\uFE0F Replay+readback confirmed on a HomeBase-attached T8425 only; standalone unverified and v3 devices use id 2735 \u2014 see CAMERA_CMD.EAS_SWITCH.",
     requires: [CAMERA_CMD.EAS_SWITCH],
     write: (v, ctx) => setScalar(CAMERA_CMD.EAS_SWITCH, asBool(v) ? 1 : 0, ctx, "auto")
@@ -5828,6 +5840,7 @@ var CAMERA_MEMBERS = {
     kind: "boolean",
     writeOnly: true,
     provenance: "verified",
+    available: isCameraCodec,
     description: "Privacy mode (PRIVACY_MODE 6250) \u2014 the multi-frame burst the sink plays.",
     write: (v, ctx) => privacyCommand(asBool(v), ctx.channel)
   },
@@ -5841,6 +5854,7 @@ var CAMERA_MEMBERS = {
     type: "bool",
     kind: "boolean",
     provenance: "verified",
+    available: isCameraCodec,
     readAvailable: (ctx) => !hasCapability(ctx, "doorbell"),
     readAliases: [{ paramType: CAMERA_CMD.DOORBELL_LED, available: (ctx) => hasCapability(ctx, "doorbell") }],
     requiresRead: true,
@@ -5864,28 +5878,28 @@ var CAMERA_MEMBERS = {
    * The refusal REJECTS on the four that answer with a promise, and THROWS on
    * {@link CAMERA_MEMBERS.recordFragments}, which answers with a handle.
    */
-  snapshotStored: provided("media", (m) => m.snapshotStored && (() => m.snapshotStored()), "Latest validated push thumbnail retained in memory.", ["snapshot"]),
-  snapshotLive: provided("media", (m, { ctx, read }) => async (opts) => {
+  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);
     return m.snapshotLive({ powered: poweredOf(ctx), ...opts });
-  }, "Fresh still decoded from a short live burst."),
+  }), "Fresh still decoded from a short live burst."),
   live: provided("media", (m, { ctx, read }) => async (opts) => {
     refuseWhenDisabled(ctx, read);
     return m.live({ powered: poweredOf(ctx), ...opts });
   }, "Open a managed live stream."),
-  record: provided("media", (m, { ctx, read }) => async (...args) => {
+  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."),
-  openReadable: provided("media", (m, { ctx, read }) => m.openReadable && (async (opts) => {
+  }), "Record N seconds \u2192 an mp4/h264 buffer."),
+  openReadable: provided("media", (m, { ctx, read }) => isCameraCodec(ctx) && m.openReadable && (async (opts) => {
     refuseWhenDisabled(ctx, read);
     return m.openReadable({ powered: poweredOf(ctx), ...opts });
   }), "Open a node:stream Readable of the live feed."),
-  recordFragments: provided("media", (m, { ctx, read }) => m.recordFragments && ((opts) => {
+  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) => 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) && m.downloadRecording && ((opts) => m.downloadRecording(opts)), "Download a recording the station holds \u2192 H.264 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
@@ -5893,7 +5907,7 @@ var CAMERA_MEMBERS = {
    * power hint `live` does; without it a battery camera talked to with no stream running would stream
    * unbounded.
    */
-  talkback: provided("media", (m, { ctx }) => m.talkback && ctx.paramIds.has(AUDIO_CMD.AUDIO_SPEAKER) && ((opts) => m.talkback({ powered: poweredOf(ctx), ...opts })), "Push audio from the host to the camera's speaker.")
+  talkback: provided("media", (m, { ctx }) => isCameraCodec(ctx) && m.talkback && ctx.paramIds.has(AUDIO_CMD.AUDIO_SPEAKER) && ((opts) => m.talkback({ powered: poweredOf(ctx), ...opts })), "Push audio from the host to the camera's speaker.")
 };
 var CAMERA = {
   capability: "camera",
@@ -5904,6 +5918,8 @@ var CAMERA = {
   detection: { codecs: ["camera"] },
   /** Only the no-argument power verbs, which carry no value for a member to hold. */
   actions({ ctx, sink }) {
+    if (!isCameraCodec(ctx))
+      return {};
     return {
       on: () => sink.dispatch(powerCommand(true, ctx)),
       off: () => sink.dispatch(powerCommand(false, ctx))
@@ -11602,6 +11618,8 @@ var MODEL_REGISTRY = {
   T8442: { codec: "camera", caps: ["arming"], name: "Indoor/Outdoor Cam 1080p" },
   // Hardwired wall-light camera; mains power asserted in MAINS_CAMERA_MODELS.
   T84A1: { codec: "camera", name: "Wall Light Cam S100" },
+  // Video lock: device_type says lock, it also streams (live view verified, HomeBase 3-attached).
+  T8530: { codec: "lock", caps: ["camera"], name: "Video Smart Lock S330" },
   // Sensors — the concrete sensor kind is curated (DeviceType 2 alone is ambiguous).
   T8900: { codec: "sensor", caps: ["contact"], name: "Entry Sensor" },
   T8910: { codec: "sensor", caps: ["battery"], name: "Motion Sensor" },
@@ -18698,16 +18716,18 @@ function h265Geometry(sps) {
   };
 }
 
-// dist/transport/p2p/live-stream.js
-var CMD_VIDEO_FRAME2 = 1300;
+// dist/transport/p2p/audio-frame.js
 var CMD_AUDIO_FRAME2 = 1301;
-var VIDEO_HEADER_LEN = 22;
 var AUDIO_HEADER_LEN = 16;
 var AUDIO_TYPE_OFFSET = 5;
+var AUDIO_CODECS = { 0: "aac-lc", 2: "g711a", 7: "aac-eld" };
+
+// dist/transport/p2p/live-stream.js
+var CMD_VIDEO_FRAME2 = 1300;
+var VIDEO_HEADER_LEN = 22;
 var SC4 = Buffer.from([0, 0, 0, 1]);
 var SC3 = Buffer.from([0, 0, 1]);
 var AAC_ELD_AUDIO_SPECIFIC_CONFIG = Buffer.from("f8f03000", "hex");
-var AUDIO_CODECS = { 0: "aac-lc", 2: "g711a", 7: "aac-eld" };
 var MAX_TRACED_DECODE_FAILURES = 3;
 var DEFAULT_KEEPALIVE_MS = 3e3;
 var LiveStream = class extends EventEmitter3 {
@@ -23423,6 +23443,8 @@ var RtcLiveStream = class extends EventEmitter7 {
   opts;
   running = false;
   startSegment = -1;
+  onConnected = () => this.sendStart();
+  onError = (error) => this.fail(error);
   keepalive;
   width = 0;
   height = 0;
@@ -23439,11 +23461,24 @@ var RtcLiveStream = class extends EventEmitter7 {
   start() {
     if (this.running)
       return this;
-    const { session, seg, accountId } = this.opts;
+    const { session } = this.opts;
     this.running = true;
+    this.startSegment = -1;
     session.on("mediaData", this.onMedia);
     session.on("commandData", this.onCommand);
     session.on("close", this.onClose);
+    if (this.opts.nvr) {
+      session.on("connected", this.onConnected);
+      session.on("error", this.onError);
+      session.connect().catch(this.onError);
+    } else
+      this.sendStart();
+    return this;
+  }
+  sendStart() {
+    if (!this.running || this.startSegment !== -1)
+      return;
+    const { session, seg, accountId, nvr } = this.opts;
     this.startSegment = seg.next();
     const sent2 = session.sendCommand(buildPortalPacket({
       commandId: PORTAL_CMD_SET_PAYLOAD,
@@ -23459,7 +23494,7 @@ var RtcLiveStream = class extends EventEmitter7 {
           camera_type: 0,
           key: "",
           msg_id: 116,
-          audio_chn: -1,
+          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 }],
@@ -23471,7 +23506,7 @@ var RtcLiveStream = class extends EventEmitter7 {
     }));
     if (!sent2) {
       queueMicrotask(() => this.fail(new Error(`rtc live ${this.tag}: command channel not open`)));
-      return this;
+      return;
     }
     this.keepalive = setInterval(() => {
       if (!session.sendRaw(PORTAL_KEEPALIVE))
@@ -23479,20 +23514,22 @@ var RtcLiveStream = class extends EventEmitter7 {
     }, PORTAL_KEEPALIVE_MS);
     this.keepalive.unref?.();
     this.opts.logger?.debug?.(`[rtc] ${this.tag} live start sent`);
-    return this;
   }
   stop() {
     if (!this.running)
       return;
     this.teardown();
     const { session, seg, accountId } = this.opts;
-    session.sendCommand(buildPortalPacket({
-      commandId: PORTAL_CMD_SET_PAYLOAD,
-      channel: PORTAL_STATION_CHANNEL,
-      segment: seg.next(),
-      isResponse: LIVE_STREAM_ID,
-      payload: { account_id: accountId, cmd: LIVE_STOP, payload: {} }
-    }));
+    if (this.startSegment !== -1)
+      session.sendCommand(buildPortalPacket({
+        commandId: PORTAL_CMD_SET_PAYLOAD,
+        channel: PORTAL_STATION_CHANNEL,
+        segment: seg.next(),
+        isResponse: LIVE_STREAM_ID,
+        payload: { account_id: accountId, cmd: LIVE_STOP, payload: {} }
+      }));
+    if (this.opts.nvr)
+      session.close();
     this.emit("stop");
   }
   teardown() {
@@ -23504,11 +23541,15 @@ var RtcLiveStream = class extends EventEmitter7 {
     session.off("mediaData", this.onMedia);
     session.off("commandData", this.onCommand);
     session.off("close", this.onClose);
+    session.off("connected", this.onConnected);
+    session.off("error", this.onError);
   }
   fail(err) {
     if (!this.running)
       return;
     this.teardown();
+    if (this.opts.nvr)
+      this.opts.session.close();
     this.emit("error", err);
   }
   /** The start's ACK: a non-zero result code ends the pull. */
@@ -23521,7 +23562,20 @@ var RtcLiveStream = class extends EventEmitter7 {
   }
   onMediaFrame(frame) {
     const h = parsePortalHeader(frame);
-    if (!h || h.commandId !== LIVE_MEDIA || h.channel !== LIVE_MEDIA_CHANNEL)
+    if (!h || h.channel !== LIVE_MEDIA_CHANNEL)
+      return;
+    if (h.commandId === CMD_AUDIO_FRAME2 && this.opts.nvr) {
+      if (h.paramLength !== frame.length - PORTAL_HEADER_LENGTH || h.paramLength <= AUDIO_HEADER_LEN)
+        return;
+      const body = frame.subarray(PORTAL_HEADER_LENGTH);
+      const codec = AUDIO_CODECS[body[AUDIO_TYPE_OFFSET]];
+      if (body.readUInt32LE(0) !== body.length - AUDIO_HEADER_LEN || codec !== "aac-lc" && codec !== "g711a")
+        return;
+      const audio = { codec, data: body.subarray(AUDIO_HEADER_LEN) };
+      this.emit("audio", audio);
+      return;
+    }
+    if (h.commandId !== LIVE_MEDIA)
       return;
     if (h.paramLength > frame.length - PORTAL_HEADER_LENGTH)
       return;
@@ -24782,38 +24836,54 @@ var RtcCommandRouter = class {
    * session. Recording has no wire here and is refused.
    */
   trackMediaProviderFor(route) {
-    const sn = route.stationSn;
-    const sourceFor = (hints = {}) => {
-      let source = this.callSources.get(sn);
+    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");
+  }
+  /** 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);
       if (!source) {
         source = new SharedLiveSource({
           makeStream: () => {
             const identity = this.deps.identity();
             if (!identity)
-              throw new Error(`rtc: not logged in, cannot call ${sn}`);
-            const session = this.newSession(route, route.adminUserId || identity.userId, identity);
-            return new RtcCallLiveStream(session, this.deps.logger);
+              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);
           },
-          label: sn,
+          label: key,
           logger: this.deps.logger,
-          powered: hints.powered,
-          preBufferSeconds: hints.preBufferSeconds,
-          warmTimeoutMs: 45e3
+          powered: opts.powered,
+          preBufferSeconds: opts.preBufferSeconds,
+          warmTimeoutMs
         });
-        this.callSources.set(sn, source);
+        this.callSources.set(key, source);
       }
       return source;
     };
     return {
       live: async (opts) => attachUnlessAborted(sourceFor(opts), opts?.signal),
       openReadable: async (opts) => openReadableFromConsumer(attachUnlessAborted(sourceFor(opts), opts?.signal), opts),
-      snapshotLive: (opts) => captureSnapshotFromShared(sourceFor(opts), {
+      snapshotLive: async (opts) => captureSnapshotFromShared(sourceFor(opts), {
         ...opts,
         logger: this.deps.logger,
         ffmpegPath: this.deps.ffmpegPath
       }),
       record: async () => {
-        throw new Error(`record is not available for ${sn} over a portal call`);
+        throw new Error(recordError);
       }
     };
   }
@@ -29446,19 +29516,24 @@ var EufyMega = class extends EventEmitter14 {
   }
   /**
    * The RTC media provider for a station on a media-track route, or a camera attached to a T9000 whose
-   * `device_channel` resolves back to it on the station; `undefined` otherwise, including a camera behind
-   * a T8N00, whose route carries commands only.
+   * `device_channel` resolves back to it on the station; `undefined` otherwise, unless an NVR camera has its own dedicated media call.
    */
   rtcMediaFor(sn) {
     const route = this.rtcRouteFor(sn);
     if (route?.mediaTrack)
       return this.rtc.trackMediaProviderFor(route);
-    if (!route?.attached || route.signalingMode === "call")
+    if (!route?.attached)
       return void 0;
-    const raw = this.registry.list().find((d) => d.sn === sn)?.raw ?? {};
+    const camera = this.registry.list().find((d) => d.sn === sn);
+    const raw = camera?.raw ?? {};
     const channel = typeof raw.device_channel === "number" ? raw.device_channel : void 0;
     if (channel === void 0 || this.registry.serialForFrame(route.stationSn, channel) !== sn)
       return void 0;
+    if (route.signalingMode === "call") {
+      if (!camera || !isNvrMediaCamera(camera))
+        return void 0;
+      return this.rtc.nvrMediaProviderFor({ ...route, cameraSn: sn, channel });
+    }
     return this.rtc.mediaProviderFor({ ...route, cameraSn: sn, channel });
   }
   /**