@mega-yfue/eufy-sdk 0.5.0-beta.57 → 0.5.0-beta.59

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

@@ -185,7 +185,8 @@ export declare class EufyMega extends EventEmitter {
      *
      * Skipped entirely for a device with a pollable cloud record, for an already-reporting device, and
      * when realtime is off — so the common path adds nothing. Resolving on timeout leaves a silent device
-     * read-less rather than failing the lookup.
+     * read-less rather than failing the lookup. A Tuya clean-line device waits on the Tuya cloud read the
+     * bring-up started, so no broker is brought up for it.
      */
     private awaitFirstRealtimeState;
     /**
@@ -245,8 +246,17 @@ export declare class EufyMega extends EventEmitter {
      * to land it under the property's name.
      */
     private rebindReads;
-    /** The distinct credential scopes the current MQTT roster needs — no devices on a scope, no connection. */
+    /**
+     * The distinct credential scopes the current MQTT roster needs — no devices on a scope, no connection.
+     * A Tuya clean-line device (`eufy_home_tuya`) needs none: the broker refuses its topics, and its state
+     * is read from the Tuya cloud.
+     */
     private mqttScopesInUse;
+    /**
+     * Read every Tuya clean-line device's DPs from the Tuya cloud and deliver them as realtime state. A
+     * failed read is reported, not fatal, and leaves that device's state as it was.
+     */
+    private readTuyaDevices;
     /**
      * Emit a semantic capability event whose name is only known at runtime (`decodeCapabilityEvent`
      * returns a plain-string `event` + `payload`). The typed `emit` overload requires a literal event
@@ -793,8 +803,7 @@ export declare class EufyMega extends EventEmitter {
      * unreachable device must not stop the rest of the roster from coming up).
      *
      * A Tuya clean-line device (`eufy_home_tuya`) is not subscribed: its state lives on the Tuya cloud,
-     * and the broker refuses its `eufy_home` topics on every credential. Its DPs are read from the Tuya
-     * cloud instead.
+     * and the broker refuses its `eufy_home` topics on every credential.
      */
     private subscribeMqttDevices;
     /**

package/dist/core/contracts.d.ts

@@ -544,6 +544,12 @@ export interface LiveVideoConfig {
     width: number;
     height: number;
 }
+/** Video frame paired with its original SDK source-arrival time. */
+export interface ReceivedVideoFrame {
+    readonly frame: LiveVideoFrame;
+    /** Wall-clock milliseconds when the shared source received the frame; preserved on replay. */
+    readonly timestampMs: number;
+}
 /**
  * Elementary-stream audio codec of a {@link LiveAudioFrame}. The station declares it per frame as a
  * byte in the `CMD_AUDIO_FRAME` header — unlike video, nothing is sniffed. These are the three values
@@ -823,12 +829,15 @@ export interface MediaProvider {
     }): Promise<Buffer>;
     /**
      * Open a video-only `node:stream` Readable over a shared source consumer — raw Annex-B bytes
-     * (default) or `objectMode` {@link LiveVideoFrame}s. Audio is available separately through
-     * {@link live} or muxed through {@link recordFragments}; it is never interleaved into raw video.
-     * The caller owns the Readable's lifetime, and destroying it releases the shared pull.
+     * (default) or `objectMode` {@link LiveVideoFrame}s. With objectMode and arrivalTime, it yields
+     * {@link ReceivedVideoFrame} envelopes whose original source-arrival time survives retained replay.
+     * Raw mode ignores arrivalTime. Audio is available separately through {@link live} or muxed through
+     * {@link recordFragments}; it is never interleaved into raw video. The caller owns the Readable's
+     * lifetime, and destroying it releases the shared pull.
      */
     openReadable?(opts?: {
         objectMode?: boolean;
+        arrivalTime?: boolean;
     } & SharedSourceHints & AbortableCall): Promise<import("node:stream").Readable>;
     /**
      * Continuously record the live feed as fragmented-MP4 (CMAF). The caller-owned

package/dist/index.js

@@ -20396,12 +20396,15 @@ function openReadableFromConsumer(consumer, opts = {}) {
       cb(err);
     }
   });
-  const onVideo = (frame) => {
-    const ok = readable.push(objectMode ? frame : frame.data);
-    if (!ok)
+  consumer.onMedia((item) => {
+    if (item.kind !== "video")
+      return;
+    const value = objectMode ? opts.arrivalTime ? { frame: item.frame, timestampMs: item.timestampMs } : item.frame : item.frame.data;
+    if (!readable.push(value))
       consumer.pause();
-  };
-  consumer.on("video", onVideo);
+  });
+  consumer.on("video", () => {
+  });
   consumer.on("stop", () => readable.push(null));
   consumer.on("error", (err) => readable.destroy(err));
   return readable;
@@ -28301,7 +28304,8 @@ var EufyMega = class extends EventEmitter13 {
    *
    * Skipped entirely for a device with a pollable cloud record, for an already-reporting device, and
    * when realtime is off — so the common path adds nothing. Resolving on timeout leaves a silent device
-   * read-less rather than failing the lookup.
+   * read-less rather than failing the lookup. A Tuya clean-line device waits on the Tuya cloud read the
+   * bring-up started, so no broker is brought up for it.
    */
   async awaitFirstRealtimeState(sn) {
     if (this.opts.autoRealtime === false || this.realtimeGeneration?.epoch !== this.realtimeEpoch)
@@ -28319,10 +28323,12 @@ var EufyMega = class extends EventEmitter13 {
     const caps = this.registry.capabilitiesForDevice(sn);
     if (!caps || !hasRealtimeReads(caps))
       return;
-    try {
-      await this.ensureMqttStarted(mqttScopeFor(dev));
-    } catch {
-      return;
+    if (!isTuyaVacuum(dev)) {
+      try {
+        await this.ensureMqttStarted(mqttScopeFor(dev));
+      } catch {
+        return;
+      }
     }
     await this.registry.awaitRealtimeState(sn, timeoutMs);
   }
@@ -28429,9 +28435,27 @@ var EufyMega = class extends EventEmitter13 {
       this.reportError(e);
     }
   }
-  /** The distinct credential scopes the current MQTT roster needs — no devices on a scope, no connection. */
+  /**
+   * The distinct credential scopes the current MQTT roster needs — no devices on a scope, no connection.
+   * A Tuya clean-line device (`eufy_home_tuya`) needs none: the broker refuses its topics, and its state
+   * is read from the Tuya cloud.
+   */
   mqttScopesInUse() {
-    return [...new Set(this.getMqttDevices().map(mqttScopeFor))];
+    return [
+      ...new Set(this.getMqttDevices().filter((d) => !isTuyaVacuum(d)).map(mqttScopeFor))
+    ];
+  }
+  /**
+   * Read every Tuya clean-line device's DPs from the Tuya cloud and deliver them as realtime state. A
+   * failed read is reported, not fatal, and leaves that device's state as it was.
+   */
+  readTuyaDevices() {
+    for (const d of this.getMqttDevices().filter(isTuyaVacuum)) {
+      this.tuya.fetchDps(d.sn).then((dps) => {
+        if (dps)
+          this.tuyaDpRouter.deliver(d.sn, dps);
+      }).catch((e) => this.reportError(e));
+    }
   }
   /**
    * Emit a semantic capability event whose name is only known at runtime (`decodeCapabilityEvent`
@@ -28942,7 +28966,7 @@ var EufyMega = class extends EventEmitter13 {
     }
     if (cmd.kind === "aiot-dp") {
       const dev = this.registry.require(sn);
-      if (dev.category === "eufy_home_tuya")
+      if (isTuyaVacuum(dev))
         return this.tuya.dispatchCommand(sn, cmd);
       return this.mqtt.dispatchCommand(sn, cmd);
     }
@@ -29000,7 +29024,7 @@ var EufyMega = class extends EventEmitter13 {
   async getDevices() {
     const devices = await this.registry.getDevices();
     for (const dev of devices) {
-      if (dev.category !== "eufy_home_tuya")
+      if (!isTuyaVacuum(dev))
         continue;
       const raw = dev.raw ?? {};
       this.tuya.registerDevice(dev.sn, tuyaDevIdFrom(raw) ?? dev.sn);
@@ -29174,6 +29198,7 @@ var EufyMega = class extends EventEmitter13 {
         await this.getDevices();
       if (epoch !== this.realtimeEpoch)
         return this.settleRealtimeGeneration(generation, "superseded");
+      this.readTuyaDevices();
       const scopes = this.mqttScopesInUse();
       readiness.mqtt = createPlaneReadiness(scopes.length);
       let push;
@@ -29663,18 +29688,10 @@ var EufyMega = class extends EventEmitter13 {
    * unreachable device must not stop the rest of the roster from coming up).
    *
    * A Tuya clean-line device (`eufy_home_tuya`) is not subscribed: its state lives on the Tuya cloud,
-   * and the broker refuses its `eufy_home` topics on every credential. Its DPs are read from the Tuya
-   * cloud instead.
+   * and the broker refuses its `eufy_home` topics on every credential.
    */
   async subscribeMqttDevices(scope, transport) {
-    for (const d of this.getMqttDevices().filter((dev) => mqttScopeFor(dev) === scope)) {
-      if (d.category === "eufy_home_tuya") {
-        this.tuya.fetchDps(d.sn).then((dps) => {
-          if (dps)
-            this.tuyaDpRouter.deliver(d.sn, dps);
-        }).catch((e) => this.reportError(e));
-        continue;
-      }
+    for (const d of this.getMqttDevices().filter((dev) => !isTuyaVacuum(dev) && mqttScopeFor(dev) === scope)) {
       try {
         await transport.subscribeDevice(d);
         await this.sendRealtimeInit(d.sn);