@mega-yfue/eufy-sdk 0.5.0-beta.72 → 0.5.0-beta.74

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";
@@ -4235,6 +4236,10 @@ function decodeAiDetectType(value) {
     pet: !!(value & AiDetectType.pet)
   };
 }
+function decodeAiDetectTypeParam(raw) {
+  const value = typeof raw === "object" && raw !== null ? raw.ai_detect_type : raw;
+  return typeof value === "number" && Number.isInteger(value) ? value : void 0;
+}
 function snoozePayload(seconds) {
   if (seconds <= 0)
     return { snooze_time: 0 };
@@ -4331,11 +4336,15 @@ var MOTION_MEMBERS = {
    * 1298 holds the detailed AI-type BITMASK (live-observed: `0x30000` enabled-base | type bits, e.g. a
    * T8425 reads `0x3000f`). Cams also report 1299 (`hbAiDetectType`) but that is a separate, simpler
    * value (1) — NOT this bitmask, so 1298 is the read/write id.
+   *
+   * The value arrives in two shapes, both read by the app's 1298 parser: a bare bitmask, or a JSON
+   * object carrying the same bitmask as `ai_detect_type` (see {@link decodeAiDetectTypeParam}).
    */
   aiDetectType: {
     param: MOTION_CMD.AI_DETECT_TYPE,
-    type: "number",
-    kind: "bitfield",
+    type: "string",
+    decode: decodeAiDetectTypeParam,
+    decodedKind: "bitfield",
     provenance: "verified",
     description: "AI detection type bitmask \u2014 which classes trigger detection. \u2705 Bits decoded live + confirmed vs the app: 0x30000 = enabled base, bit0 = human recognition, bit1 = human detection, bit2 = vehicle, bit3 = pet (see AiDetectType / encodeAiDetectType). \u2705 WRITE HW-verified live on T8124 (1350 SET_PAYLOAD, {ai_detect_type, channel}): each write landed byte-exact + read back (0x30003 \u2192 0x8 \u2192 0x3000b).",
     write: (v, ctx) => {
@@ -12336,10 +12345,13 @@ var SECURITY_PARAMS = {
     type: "string",
     provenance: "apk"
   },
+  // A camera answers a bare bitmask; a camera behind an NVR-class hub answers a JSON object carrying
+  // it as `ai_detect_type` beside `ai_switch`, `ai_notification`, `ai_use_global` and `channel`.
   1298: {
     name: "aiDetectType",
-    type: "number",
-    provenance: "apk"
+    type: "string",
+    provenance: "apk",
+    encoding: "json"
   },
   // Cameras and a HomeBase 3 answer a bare number; a HomeBase S1 Pro (T9000) answers a JSON envelope
   // (`{"ai_switch":1,"smart_detection":…,"devlist":[…]}`).
@@ -13219,7 +13231,7 @@ var CLEAN_PARAMS = {
   },
   155: {
     name: "direction",
-    type: "enum",
+    type: "string",
     provenance: "mega"
   },
   156: {
@@ -18687,16 +18699,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 {
@@ -23412,6 +23426,8 @@ var RtcLiveStream = class extends EventEmitter7 {
   opts;
   running = false;
   startSegment = -1;
+  onConnected = () => this.sendStart();
+  onError = (error) => this.fail(error);
   keepalive;
   width = 0;
   height = 0;
@@ -23428,11 +23444,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,
@@ -23448,7 +23477,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 }],
@@ -23460,7 +23489,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))
@@ -23468,20 +23497,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() {
@@ -23493,11 +23524,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. */
@@ -23510,7 +23545,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;
@@ -24771,38 +24819,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);
       }
     };
   }
@@ -29435,19 +29499,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 });
   }
   /**