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

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

@@ -1,3 +1,4 @@
+import { isCameraCodec } from "./access.js";
 import { type Surface } from "./members.js";
 import type { AvailabilityContext, CapabilityModule, CommandContext } from "./types.js";
 import { type Command, type MediaProvider } from "../../core/contracts.js";
@@ -300,6 +301,7 @@ export declare const CAMERA_MEMBERS: {
         readonly type: "bool";
         readonly kind: "boolean";
         readonly provenance: "verified";
+        readonly available: typeof isCameraCodec;
         readonly invert: true;
         readonly invertFor: (ctx: AvailabilityContext) => false | undefined;
         readonly readAliases: readonly [{
@@ -334,6 +336,7 @@ export declare const CAMERA_MEMBERS: {
         readonly type: "bool";
         readonly kind: "boolean";
         readonly provenance: "apk";
+        readonly available: typeof isCameraCodec;
         readonly description: string;
         readonly write: (v: string | number | boolean, ctx: CommandContext) => Command;
     };
@@ -353,6 +356,7 @@ export declare const CAMERA_MEMBERS: {
             readonly 2: "Timestamp + Logo";
         };
         readonly provenance: "verified";
+        readonly available: typeof isCameraCodec;
         readonly description: string;
         readonly write: (v: string | number | boolean, ctx: CommandContext) => Command | undefined;
     };
@@ -366,6 +370,7 @@ export declare const CAMERA_MEMBERS: {
         readonly type: "bool";
         readonly kind: "boolean";
         readonly provenance: "verified";
+        readonly available: typeof isCameraCodec;
         readonly description: string;
         readonly write: (v: string | number | boolean, ctx: CommandContext) => Command;
     };
@@ -381,6 +386,7 @@ export declare const CAMERA_MEMBERS: {
         readonly type: "number";
         readonly kind: "scalar";
         readonly provenance: "verified";
+        readonly available: typeof isCameraCodec;
         readonly description: string;
         readonly write: (v: string | number | boolean, ctx: CommandContext) => Command | undefined;
     };
@@ -398,6 +404,7 @@ export declare const CAMERA_MEMBERS: {
             readonly 2: "All Sound";
         };
         readonly provenance: "verified";
+        readonly available: typeof isCameraCodec;
         readonly description: string;
         readonly write: (v: string | number | boolean, ctx: CommandContext) => Command | undefined;
     };
@@ -419,6 +426,7 @@ export declare const CAMERA_MEMBERS: {
             readonly 3: "Text First, Then Thumbnail";
         };
         readonly provenance: "verified";
+        readonly available: typeof isCameraCodec;
         readonly description: string;
         readonly write: (v: string | number | boolean, ctx: CommandContext) => Command | undefined;
     };
@@ -438,6 +446,7 @@ export declare const CAMERA_MEMBERS: {
             readonly 2: "Full Color";
         };
         readonly provenance: "verified";
+        readonly available: typeof isCameraCodec;
         readonly description: string;
         readonly write: (v: string | number | boolean, ctx: CommandContext) => Command | undefined;
     };
@@ -461,6 +470,7 @@ export declare const CAMERA_MEMBERS: {
         readonly kind: "enum";
         readonly enumValues: Readonly<Record<number, string>>;
         readonly provenance: "verified";
+        readonly available: typeof isCameraCodec;
         readonly args: readonly [{
             readonly name: "quality";
             readonly kind: "enum";
@@ -479,6 +489,7 @@ export declare const CAMERA_MEMBERS: {
         readonly param: 2731;
         readonly type: "string";
         readonly provenance: "verified";
+        readonly available: typeof isCameraCodec;
         readonly decode: (raw: unknown) => number | undefined;
         readonly decodedKind: "enum";
         readonly decodedValues: number[];
@@ -500,6 +511,7 @@ export declare const CAMERA_MEMBERS: {
         readonly type: "bool";
         readonly kind: "boolean";
         readonly provenance: "apk";
+        readonly available: typeof isCameraCodec;
         readonly description: string;
         readonly requires: readonly [1015];
         readonly write: (v: string | number | boolean, ctx: CommandContext) => Command;
@@ -517,6 +529,7 @@ export declare const CAMERA_MEMBERS: {
         readonly kind: "boolean";
         readonly writeOnly: true;
         readonly provenance: "verified";
+        readonly available: typeof isCameraCodec;
         readonly description: "Privacy mode (PRIVACY_MODE 6250) — the multi-frame burst the sink plays.";
         readonly write: (v: string | number | boolean, ctx: CommandContext) => Command;
     };
@@ -530,6 +543,7 @@ export declare const CAMERA_MEMBERS: {
         readonly type: "bool";
         readonly kind: "boolean";
         readonly provenance: "verified";
+        readonly available: typeof isCameraCodec;
         readonly readAvailable: (ctx: AvailabilityContext) => boolean;
         readonly readAliases: readonly [{
             readonly paramType: 1716;
@@ -556,21 +570,21 @@ export declare const 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.
      */
-    readonly snapshotStored: import("./members.js").ProvidedMember<"media", (() => Promise<Buffer<ArrayBufferLike>>) | undefined>;
-    readonly snapshotLive: import("./members.js").ProvidedMember<"media", (opts?: Parameters<MediaProvider["snapshotLive"]>[0]) => Promise<{
+    readonly snapshotStored: import("./members.js").ProvidedMember<"media", false | (() => Promise<Buffer<ArrayBufferLike>>) | undefined>;
+    readonly snapshotLive: import("./members.js").ProvidedMember<"media", false | ((opts?: Parameters<MediaProvider["snapshotLive"]>[0]) => Promise<{
         jpeg: Buffer;
         width: number;
         height: number;
         retained?: true;
-    }>>;
+    }>)>;
     readonly live: import("./members.js").ProvidedMember<"media", (opts?: Parameters<MediaProvider["live"]>[0]) => Promise<import("../../core/contracts.js").LiveStreamConsumer>>;
-    readonly record: import("./members.js").ProvidedMember<"media", (seconds: number, opts?: {
+    readonly record: import("./members.js").ProvidedMember<"media", false | ((seconds: number, opts?: {
         timeoutMs?: number;
         skipKeyframes?: number;
-    } | undefined) => Promise<Buffer<ArrayBufferLike>>>;
-    readonly openReadable: import("./members.js").ProvidedMember<"media", ((opts?: Parameters<NonNullable<MediaProvider["openReadable"]>>[0]) => Promise<import("node:stream").Readable>) | undefined>;
-    readonly recordFragments: import("./members.js").ProvidedMember<"media", ((opts?: Parameters<NonNullable<MediaProvider["recordFragments"]>>[0]) => import("../../core/contracts.js").FragmentRecordingHandle) | undefined>;
-    readonly downloadRecording: import("./members.js").ProvidedMember<"media", ((opts: Parameters<NonNullable<MediaProvider["downloadRecording"]>>[0]) => Promise<import("../../core/contracts.js").RecordingDownload>) | undefined>;
+    } | undefined) => Promise<Buffer<ArrayBufferLike>>)>;
+    readonly openReadable: import("./members.js").ProvidedMember<"media", false | ((opts?: Parameters<NonNullable<MediaProvider["openReadable"]>>[0]) => Promise<import("node:stream").Readable>) | undefined>;
+    readonly recordFragments: import("./members.js").ProvidedMember<"media", false | ((opts?: Parameters<NonNullable<MediaProvider["recordFragments"]>>[0]) => import("../../core/contracts.js").FragmentRecordingHandle) | undefined>;
+    readonly downloadRecording: import("./members.js").ProvidedMember<"media", false | ((opts: Parameters<NonNullable<MediaProvider["downloadRecording"]>>[0]) => Promise<import("../../core/contracts.js").RecordingDownload>) | undefined>;
     /**
      * 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

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.73",
+  "version": "0.5.0-beta.75",
   "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",