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

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;