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

package/dist/model/capabilities/motion.d.ts

@@ -182,6 +182,11 @@ export interface AiDetectFlags {
 export declare function encodeAiDetectType(flags: AiDetectFlags): number;
 /** Decode an `ai_detect_type` bitmask → which detection types are on. */
 export declare function decodeAiDetectType(value: number): AiDetectFlags;
+/**
+ * The `ai_detect_type` bitmask from a stored 1298 value: the bare number, or the numeric
+ * `ai_detect_type` field of the JSON object form. Answers `undefined` for any other shape.
+ */
+declare function decodeAiDetectTypeParam(raw: unknown): number | undefined;
 /**
  * Decode a `radar_wd_switch` (2706, loitering) read the way the app does:
  * `typeof v === "object" ? v.radar_wd_switch : v`. The device may store it as a JSON object
@@ -245,11 +250,15 @@ export declare const 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}).
      */
     readonly aiDetectType: {
         readonly param: 1298;
-        readonly type: "number";
-        readonly kind: "bitfield";
+        readonly type: "string";
+        readonly decode: typeof decodeAiDetectTypeParam;
+        readonly decodedKind: "bitfield";
         readonly provenance: "verified";
         readonly description: string;
         readonly write: (v: string | number | boolean, ctx: CommandContext) => Command | undefined;
@@ -379,3 +388,4 @@ export declare const MOTION_MEMBERS: {
     };
 };
 export declare const MOTION: CapabilityModule;
+export {};

package/dist/model/device-family.d.ts

@@ -47,6 +47,8 @@ export declare const isHomeBase: (ctx: FamilyContext) => boolean;
 export declare const isStation9000: (ctx: FamilyContext) => boolean;
 /** T8N00 NVR, identified by its reported model. */
 export declare const isNvrT8N00: (ctx: FamilyContext) => boolean;
+/** PoE cameras whose media is served by their NVR's portal call. */
+export declare const isNvrMediaCamera: (ctx: FamilyContext) => boolean;
 /** Video Doorbell C31 (T8223), identified by its reported model. */
 export declare const isDoorbellT8223: (ctx: FamilyContext) => boolean;
 /** Wired doorbell (DeviceType.DOORBELL). */

package/dist/transport/p2p/audio-frame.d.ts

@@ -0,0 +1,14 @@
+import type { AudioCodec } from "../../core/contracts.js";
+export declare const CMD_AUDIO_FRAME = 1301;
+/** Length of the audio frame header before the payload. */
+export declare const AUDIO_HEADER_LEN = 16;
+/** Byte offset of the codec id between the frame-size and frame-number fields. */
+export declare const AUDIO_TYPE_OFFSET = 5;
+/**
+ * Codec ids the station puts at {@link AUDIO_TYPE_OFFSET}, as the v6 app maps them
+ * (`AudioReader.AAC_LC = 0`, `G711A = 2`, `AAC_ELD = 7`).
+ *
+ * The app's `PCM_SILENCE = -1` is absent on purpose: it is not a wire value. The app injects it
+ * itself when a stream produces no audio at all, to feed its decoder silence.
+ */
+export declare const AUDIO_CODECS: Readonly<Record<number, AudioCodec>>;

package/dist/transport/rtc/command-router.d.ts

@@ -85,6 +85,10 @@ export declare class RtcCommandRouter {
      * session. Recording has no wire here and is refused.
      */
     trackMediaProviderFor(route: RtcRoute): MediaProvider;
+    /** NVR media uses a dedicated call per camera, independent of station commands. */
+    nvrMediaProviderFor(route: RtcLiveRoute): MediaProvider;
+    /** Share a dedicated-call source and its consumer operations under one route key. */
+    private callMediaProviderFor;
     /**
      * Tear down every station session (logout / shutdown). Each live source is disposed before its session
      * closes, so its consumers end cleanly and its stop still rides the session.

package/dist/transport/rtc/live.d.ts

@@ -1,5 +1,5 @@
 /**
- * The live pull of one camera behind a **HomeBase S1 Pro (T9000)**, over the station's control session.
+ * A portal camera live pull: T9000 shares its control session, NVR media owns a dedicated call.
  *
  * Wire, as the portal sends it on the command data channel:
  *
@@ -12,8 +12,8 @@
  *  - A raw, unframed keepalive (a 20-byte prefix and a bare `XZYH 1139`) goes out every ~29 s; the hub
  *    echoes it.
  *
- * The station serves one live view at a time on that play slot, so the router builds at most one pull per
- * station. This is a {@link LiveStreamHandle}: fan-out, backpressure and the start deadline are the
+ * A session serves one live view on that play slot. This is a {@link LiveStreamHandle}:
+ * fan-out, backpressure and the start deadline are the
  * shared live source's.
  */
 import { EventEmitter } from "node:events";
@@ -42,15 +42,19 @@ export interface RtcLiveOptions {
     /** The station's `member.admin_user_id`. */
     accountId: string;
     logger?: Logger;
+    /** NVR media owns and connects its session; uses the portal default sensor. */
+    nvr?: boolean;
 }
 /**
  * One camera's live pull. `start()` sends the start; a non-zero start ACK or a closed session ends it with
- * `error`, and `stop()` sends the stop. Frames are `h265` Annex B, keyframes being IDRs.
+ * `error`, and `stop()` sends the stop. Video is H.265 Annex B, keyframes being IDRs.
  */
 export declare class RtcLiveStream extends EventEmitter implements LiveStreamHandle {
     private readonly opts;
     private running;
     private startSegment;
+    private readonly onConnected;
+    private readonly onError;
     private keepalive?;
     private width;
     private height;
@@ -60,6 +64,7 @@ export declare class RtcLiveStream extends EventEmitter implements LiveStreamHan
     constructor(opts: RtcLiveOptions);
     private get tag();
     start(): this;
+    private sendStart;
     stop(): void;
     private teardown;
     private fail;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mega-yfue/eufy-sdk",
-  "version": "0.5.0-beta.72",
+  "version": "0.5.0-beta.74",
   "description": "One typed TypeScript client for the Anker eufy v6 cloud — capability-driven devices, realtime events over P2P/MQTT/push, and live media",
   "license": "Apache-2.0",
   "author": "mega-yfue",