@mega-yfue/eufy-sdk 0.4.0-beta.5 → 0.4.0-beta.7

package/dist/core/contracts.d.ts

@@ -684,8 +684,8 @@ export interface SharedSourceHints {
      */
     powered?: "wired" | "battery";
     /**
-     * Seconds of already-captured media the pull retains for a later drain; `0`, absent, non-finite and
-     * negative values retain none.
+     * Seconds of already-captured media the pull retains for a later drain; `0`, absent, non-finite,
+     * negative, and windows longer than 2,147,483,647 ms retain none.
      *
      * Retention costs memory on every frame and only a caller knows whether anything will drain it, so it
      * is never assumed. Media can only be retained while the pull is running, so a window answers "what did

package/dist/index.js

@@ -15178,6 +15178,7 @@ var LOCAL_LOOKUP_PORT = 32108;
 var HEARTBEAT_MS = 5e3;
 var PATH_SILENCE_MS = HEARTBEAT_MS * 3;
 var LOOKUP_RETRY_MS = 1e3;
+var RECEIVE_BUFFER_BYTES = 4 * 1024 * 1024;
 var CONNECT_TIMEOUT_MS = 15e3;
 var STATION_CHANNEL3 = 255;
 var CMD_GATEWAYINFO = 1100;
@@ -15233,6 +15234,8 @@ var P2PSession = class _P2PSession extends EventEmitter2 {
   connected = false;
   connecting = false;
   closed = false;
+  /** Whether a short receive buffer has been reported, so a reconnect does not repeat the same warning. */
+  receiveBufferReported = false;
   connectAddress;
   seqNumber = 0;
   /**
@@ -15555,6 +15558,26 @@ var P2PSession = class _P2PSession extends EventEmitter2 {
   get isConnected() {
     return this.connected;
   }
+  /**
+   * Ask the OS for {@link RECEIVE_BUFFER_BYTES} on a bound socket, and warn once per session when it grants
+   * less or refuses.
+   *
+   * The request is made here rather than through `createSocket`'s `recvBufferSize`: Node applies that option
+   * inside the bind callback, where a refusal is thrown out of reach of this session and ends the process.
+   */
+  requestReceiveBuffer(socket) {
+    let granted;
+    try {
+      socket.setRecvBufferSize(RECEIVE_BUFFER_BYTES);
+      granted = socket.getRecvBufferSize();
+    } catch {
+      granted = 0;
+    }
+    if (granted >= RECEIVE_BUFFER_BYTES || this.receiveBufferReported)
+      return;
+    this.receiveBufferReported = true;
+    this.logger.warn(`[p2p] ${this.cfg.stationSn} UDP receive buffer below the ${RECEIVE_BUFFER_BYTES} bytes requested` + (granted > 0 ? ` (granted ${granted})` : " (request refused)") + `; live video can lose keyframes. Raise the OS limit (net.core.rmem_max on Linux, kern.ipc.maxsockbuf on BSD) to at least ${RECEIVE_BUFFER_BYTES}.`);
+  }
   /** Open the socket and start the lookup → hole-punch handshake. */
   async connect() {
     if (this.connecting || this.connected)
@@ -15578,6 +15601,7 @@ var P2PSession = class _P2PSession extends EventEmitter2 {
           socket.setBroadcast(true);
         } catch {
         }
+        this.requestReceiveBuffer(socket);
         resolve();
       });
     });
@@ -18197,9 +18221,9 @@ function annexbToJpeg(annexb, spawn2) {
 
 // dist/transport/p2p/shared-live-source.js
 import { EventEmitter as EventEmitter4 } from "node:events";
-function durationMs(seconds) {
-  const milliseconds = (seconds ?? 0) * 1e3;
-  return Number.isFinite(milliseconds) && milliseconds > 0 ? milliseconds : 0;
+var MAX_TIMER_DELAY_MS = 2147483647;
+function timerMs(value, fallback) {
+  return value !== void 0 && Number.isFinite(value) && value >= 1 && value <= MAX_TIMER_DELAY_MS ? value : fallback;
 }
 function sameConfig(a, b) {
   return b !== void 0 && a.codec === b.codec && a.width === b.width && a.height === b.height;
@@ -18452,14 +18476,14 @@ var SharedLiveSource = class {
   tag;
   constructor(opts) {
     this.opts = opts;
-    this.lingerMs = opts.lingerMs ?? 8e3;
+    this.lingerMs = opts.lingerMs === 0 ? 1 : timerMs(opts.lingerMs, 8e3);
     this.maxQueue = opts.maxQueue ?? 900;
-    this.preBufferMs = durationMs(opts.preBufferSeconds);
-    this.warmRetryMs = opts.warmRetryMs ?? 2e3;
-    this.warmTimeoutMs = opts.warmTimeoutMs ?? 2e4;
+    this.preBufferMs = timerMs((opts.preBufferSeconds ?? 0) * 1e3, 0);
+    this.warmRetryMs = timerMs(opts.warmRetryMs, 2e3);
+    this.warmTimeoutMs = timerMs(opts.warmTimeoutMs, 2e4);
     this.powered = opts.powered ?? "wired";
-    this.batteryBudgetMs = opts.batteryBudgetMs ?? 45e3;
-    this.budgetGraceMs = opts.budgetGraceMs ?? 1e4;
+    this.batteryBudgetMs = timerMs(opts.batteryBudgetMs, 45e3);
+    this.budgetGraceMs = timerMs(opts.budgetGraceMs, 1e4);
     this.logger = opts.logger ?? noopLogger;
     this.tag = opts.label ? `[live ${opts.label}]` : "[live]";
     this.traceId = `pull-${++pullSequence}`;
@@ -18707,7 +18731,7 @@ var SharedLiveSource = class {
     if (this.disposed || !this.stream)
       return;
     this.clearBudget();
-    this.budgetTimer.arm(ms ?? this.batteryBudgetMs, () => this.onBudgetExpire());
+    this.budgetTimer.arm(timerMs(ms, this.batteryBudgetMs), () => this.onBudgetExpire());
   }
   /** Settle a reuse watch on any frame — the join already holds a decodable picture. */
   settleReuseWatch() {
@@ -18848,7 +18872,7 @@ var SharedLiveSource = class {
     return this.bufferedMedia(seconds).filter((item) => item.kind === "video").map((item) => item.frame);
   }
   bufferedMedia(seconds) {
-    const requested = Math.min(durationMs(seconds), this.preBufferMs);
+    const requested = Number.isFinite(seconds) ? Math.min(seconds * 1e3, this.preBufferMs) : 0;
     if (requested <= 0 || !this.ring.length)
       return [];
     const start = this.windowStart(Date.now() - requested);