@apocaliss92/nodelink-js 0.4.11 → 0.4.13

package/dist/index.js

@@ -45,7 +45,54 @@ import {
   parseSupportXml,
   setGlobalLogger,
   xmlIndicatesFloodlight
-} from "./chunk-HGQ53FB3.js";
+} from "./chunk-R5AJV73A.js";
+import {
+  ReolinkCgiApi,
+  ReolinkHttpClient,
+  applyStreamPatch,
+  applyXmlTagPatch,
+  buildAbilityInfoExtensionXml,
+  buildBinaryExtensionXml,
+  buildChannelExtensionXml,
+  buildFloodlightManualXml,
+  buildLoginXml,
+  buildLogoutXml,
+  buildPreviewStopXml,
+  buildPreviewStopXmlV11,
+  buildPreviewXml,
+  buildPreviewXmlV11,
+  buildPtzControlXml,
+  buildPtzPresetXml,
+  buildPtzPresetXmlV2,
+  buildRtspPath,
+  buildRtspUrl,
+  buildSirenManualXml,
+  buildSirenTimesXml,
+  buildStartZoomFocusXml,
+  buildWhiteLedStateXml,
+  captureModelFixtures,
+  collectCgiDiagnostics,
+  collectMultifocalDiagnostics,
+  collectNativeDiagnostics,
+  collectNvrDiagnostics,
+  computeExpectedStreamCompatibility,
+  createDiagnosticsBundle,
+  ensureXmlHeader,
+  getXmlText,
+  normalizeDayNightMode,
+  normalizeOpenClose,
+  parseRecordingFileName,
+  patchNestedTag,
+  printNvrDiagnostics,
+  runAllDiagnosticsConsecutively,
+  runMultifocalDiagnosticsConsecutively,
+  sampleStreams,
+  sanitizeFixtureData,
+  testChannelStreams,
+  upsertXmlTag,
+  xmlEscape,
+  zipDirectory
+} from "./chunk-2JNXKT3C.js";
 import {
   AesStreamDecryptor,
   BC_AES_IV,
@@ -91,6 +138,7 @@ import {
   BC_CMD_ID_GET_AUDIO_CFG,
   BC_CMD_ID_GET_AUDIO_TASK,
   BC_CMD_ID_GET_AUTO_FOCUS,
+  BC_CMD_ID_GET_AUTO_REBOOT,
   BC_CMD_ID_GET_BATTERY_INFO,
   BC_CMD_ID_GET_BATTERY_INFO_LIST,
   BC_CMD_ID_GET_DAY_NIGHT_THRESHOLD,
@@ -98,6 +146,8 @@ import {
   BC_CMD_ID_GET_DING_DONG_CFG,
   BC_CMD_ID_GET_DING_DONG_LIST,
   BC_CMD_ID_GET_DING_DONG_SILENT,
+  BC_CMD_ID_GET_DST,
+  BC_CMD_ID_GET_EMAIL,
   BC_CMD_ID_GET_EMAIL_TASK,
   BC_CMD_ID_GET_ENC,
   BC_CMD_ID_GET_FTP_TASK,
@@ -105,6 +155,7 @@ import {
   BC_CMD_ID_GET_KIT_AP_CFG,
   BC_CMD_ID_GET_LED_STATE,
   BC_CMD_ID_GET_MOTION_ALARM,
+  BC_CMD_ID_GET_NTP,
   BC_CMD_ID_GET_ONLINE_USER_LIST,
   BC_CMD_ID_GET_OSD_DATETIME,
   BC_CMD_ID_GET_PIR_INFO,
@@ -121,6 +172,7 @@ import {
   BC_CMD_ID_GET_SUPPORT,
   BC_CMD_ID_GET_SYSTEM_GENERAL,
   BC_CMD_ID_GET_TIMELAPSE_CFG,
+  BC_CMD_ID_GET_VERSION_INFO,
   BC_CMD_ID_GET_VIDEO_INPUT,
   BC_CMD_ID_GET_WHITE_LED,
   BC_CMD_ID_GET_WIFI,
@@ -144,18 +196,24 @@ import {
   BC_CMD_ID_SET_AUDIO_CFG,
   BC_CMD_ID_SET_AUDIO_TASK,
   BC_CMD_ID_SET_AUTO_FOCUS,
+  BC_CMD_ID_SET_AUTO_REBOOT,
   BC_CMD_ID_SET_DAY_NIGHT_THRESHOLD,
   BC_CMD_ID_SET_DING_DONG_CFG,
   BC_CMD_ID_SET_DING_DONG_SILENT,
+  BC_CMD_ID_SET_DST,
+  BC_CMD_ID_SET_EMAIL,
   BC_CMD_ID_SET_EMAIL_TASK,
   BC_CMD_ID_SET_ENC,
   BC_CMD_ID_SET_LED_STATE,
   BC_CMD_ID_SET_MOTION_ALARM,
+  BC_CMD_ID_SET_NTP,
+  BC_CMD_ID_SET_OSD_DATETIME,
   BC_CMD_ID_SET_PIR_INFO,
   BC_CMD_ID_SET_PRIVACY_MASK,
   BC_CMD_ID_SET_PUSH_TASK,
   BC_CMD_ID_SET_RECORD,
   BC_CMD_ID_SET_RECORD_CFG,
+  BC_CMD_ID_SET_SYSTEM_GENERAL,
   BC_CMD_ID_SET_VIDEO_INPUT,
   BC_CMD_ID_SET_WHITE_LED_STATE,
   BC_CMD_ID_SET_WHITE_LED_TASK,
@@ -165,6 +223,7 @@ import {
   BC_CMD_ID_TALK_ABILITY,
   BC_CMD_ID_TALK_CONFIG,
   BC_CMD_ID_TALK_RESET,
+  BC_CMD_ID_TEST_EMAIL,
   BC_CMD_ID_UDP_KEEP_ALIVE,
   BC_CMD_ID_VIDEO,
   BC_CMD_ID_VIDEO_STOP,
@@ -177,52 +236,20 @@ import {
   BcMediaCodec,
   H264RtpDepacketizer,
   H265RtpDepacketizer,
-  ReolinkCgiApi,
-  ReolinkHttpClient,
   aesDecrypt,
   aesEncrypt,
-  applyStreamPatch,
-  applyXmlTagPatch,
   bcDecrypt,
   bcEncrypt,
   bcHeaderHasPayloadOffset,
-  buildAbilityInfoExtensionXml,
-  buildBinaryExtensionXml,
-  buildChannelExtensionXml,
-  buildFloodlightManualXml,
-  buildLoginXml,
-  buildLogoutXml,
-  buildPreviewStopXml,
-  buildPreviewStopXmlV11,
-  buildPreviewXml,
-  buildPreviewXmlV11,
-  buildPtzControlXml,
-  buildPtzPresetXml,
-  buildPtzPresetXmlV2,
-  buildRtspPath,
-  buildRtspUrl,
-  buildSirenManualXml,
-  buildSirenTimesXml,
-  buildStartZoomFocusXml,
-  buildWhiteLedStateXml,
-  captureModelFixtures,
-  collectCgiDiagnostics,
-  collectMultifocalDiagnostics,
-  collectNativeDiagnostics,
-  collectNvrDiagnostics,
-  computeExpectedStreamCompatibility,
   convertToAnnexB,
   convertToAnnexB2,
   convertToLengthPrefixed,
-  createDiagnosticsBundle,
   deriveAesKey,
   detectVideoCodecFromNal,
-  ensureXmlHeader,
   extractPpsFromAnnexB,
   extractSpsFromAnnexB,
   extractVpsFromAnnexB,
   getH265NalType,
-  getXmlText,
   hasStartCodes,
   hasStartCodes2,
   isH264KeyframeAnnexB,
@@ -232,22 +259,10 @@ import {
   isValidH265AnnexBAccessUnit,
   md5HexUpper,
   md5StrModern,
-  normalizeDayNightMode,
-  normalizeOpenClose,
   parseBcMedia,
-  parseRecordingFileName,
-  patchNestedTag,
-  printNvrDiagnostics,
-  runAllDiagnosticsConsecutively,
-  runMultifocalDiagnosticsConsecutively,
-  sampleStreams,
-  sanitizeFixtureData,
   splitAnnexBToNalPayloads,
-  splitAnnexBToNalPayloads2,
-  testChannelStreams,
-  xmlEscape,
-  zipDirectory
-} from "./chunk-EDLMKBG2.js";
+  splitAnnexBToNalPayloads2
+} from "./chunk-C57QV7IL.js";
 
 // src/reolink/baichuan/HlsSessionManager.ts
 var withTimeout = async (p, ms, label) => {
@@ -4757,6 +4772,17 @@ var Go2rtcTcpServer = class _Go2rtcTcpServer extends EventEmitter2 {
   // Native stream
   nativeFanout = null;
   nativeStreamActive = false;
+  // Set only by stopNativeStream() (explicit teardown) so the fanout's onEnd
+  // callback can short-circuit cleanup/restart logic. NOT set by the inactivity-
+  // timeout force-restart path — that flow wants onEnd to run and decide
+  // whether to restart based on prestartStream / connected clients.
+  nativeStreamStopping = false;
+  // Pending retry timer for the unbounded auto-restart loop. When a stream
+  // start fails transiently (camera in maintenance reboot, idle-disconnect
+  // race, etc.) we keep trying with exponential backoff until either the
+  // server is stopped or a frame finally arrives.
+  nativeStreamRetryTimer;
+  nativeStreamRetryDelayMs = 0;
   dedicatedSessionRelease;
   detectedVideoType;
   // Client tracking
@@ -4825,6 +4851,7 @@ var Go2rtcTcpServer = class _Go2rtcTcpServer extends EventEmitter2 {
     if (!this.active) return;
     this.active = false;
     clearTimeout(this.stopGraceTimer);
+    this.clearNativeStreamRetry();
     this.stopStreamHealthMonitor();
     for (const [id, sock] of this.clientSockets) {
       sock.destroy();
@@ -5153,6 +5180,46 @@ var Go2rtcTcpServer = class _Go2rtcTcpServer extends EventEmitter2 {
   // -----------------------------------------------------------------------
   // Native stream management
   // -----------------------------------------------------------------------
+  /**
+   * Schedule another startNativeStream() attempt after the given delay.
+   * Idempotent: a no-op if a retry is already scheduled, the server is no
+   * longer active, or an explicit stop is in progress. Implements unbounded
+   * exponential backoff (5s → 60s) so a camera that stays unreachable for
+   * minutes (e.g. nightly maintenance reboot) eventually recovers without
+   * manual intervention — see issue #16.
+   */
+  scheduleNativeStreamRetry(reason) {
+    if (!this.active) return;
+    if (this.nativeStreamStopping) return;
+    if (this.nativeStreamRetryTimer) return;
+    const delay = this.nativeStreamRetryDelayMs > 0 ? this.nativeStreamRetryDelayMs : 5e3;
+    this.logger.info?.(
+      `[Go2rtcTcpServer] scheduling native stream retry in ${(delay / 1e3).toFixed(0)}s (reason=${reason})`
+    );
+    this.nativeStreamRetryTimer = setTimeout(() => {
+      this.nativeStreamRetryTimer = void 0;
+      if (!this.active) return;
+      if (this.nativeStreamStopping) return;
+      this.startNativeStream().catch((err) => {
+        this.logger.warn?.(
+          `[Go2rtcTcpServer] retry of startNativeStream threw: ${err instanceof Error ? err.message : err}`
+        );
+      });
+    }, delay);
+    this.nativeStreamRetryDelayMs = Math.min(delay * 2, 6e4);
+  }
+  /**
+   * Cancel any pending retry timer and reset the backoff. Called on explicit
+   * stop and on first-frame-received so the next failure starts the backoff
+   * window from scratch.
+   */
+  clearNativeStreamRetry() {
+    if (this.nativeStreamRetryTimer) {
+      clearTimeout(this.nativeStreamRetryTimer);
+      this.nativeStreamRetryTimer = void 0;
+    }
+    this.nativeStreamRetryDelayMs = 0;
+  }
   async startNativeStream() {
     if (this.nativeStreamActive) return;
     if (!this.api.isReady) {
@@ -5169,8 +5236,9 @@ var Go2rtcTcpServer = class _Go2rtcTcpServer extends EventEmitter2 {
         await this.api.ensureConnected();
       } catch (e) {
         this.logger.warn?.(
-          `[Go2rtcTcpServer] ensureConnected failed, aborting stream start: ${e}`
+          `[Go2rtcTcpServer] ensureConnected failed: ${e}`
         );
+        this.scheduleNativeStreamRetry("ensureConnected failed");
         return;
       }
     }
@@ -5200,6 +5268,9 @@ var Go2rtcTcpServer = class _Go2rtcTcpServer extends EventEmitter2 {
         ...dedicatedClient ? { client: dedicatedClient } : {}
       }),
       onFrame: (frame) => {
+        if (!hadFrames) {
+          this.clearNativeStreamRetry();
+        }
         hadFrames = true;
         this.lastFrameAt = Date.now();
         this.totalFramesReceived++;
@@ -5243,7 +5314,7 @@ var Go2rtcTcpServer = class _Go2rtcTcpServer extends EventEmitter2 {
         this.logger.warn?.(`[Go2rtcTcpServer] native stream error: ${error}`);
       },
       onEnd: () => {
-        if (!this.nativeStreamActive) return;
+        if (this.nativeStreamStopping) return;
         this.nativeStreamActive = false;
         this.nativeFanout = null;
         this.stopStreamHealthMonitor();
@@ -5285,18 +5356,24 @@ var Go2rtcTcpServer = class _Go2rtcTcpServer extends EventEmitter2 {
     this.startStreamHealthMonitor();
   }
   async stopNativeStream() {
+    this.nativeStreamStopping = true;
     this.nativeStreamActive = false;
+    this.clearNativeStreamRetry();
     this.stopStreamHealthMonitor();
     const fanout = this.nativeFanout;
     this.nativeFanout = null;
-    if (fanout) {
-      await fanout.stop();
-    }
-    this.prebuffer = [];
-    if (this.dedicatedSessionRelease) {
-      await this.dedicatedSessionRelease().catch(() => {
-      });
-      this.dedicatedSessionRelease = void 0;
+    try {
+      if (fanout) {
+        await fanout.stop();
+      }
+      this.prebuffer = [];
+      if (this.dedicatedSessionRelease) {
+        await this.dedicatedSessionRelease().catch(() => {
+        });
+        this.dedicatedSessionRelease = void 0;
+      }
+    } finally {
+      this.nativeStreamStopping = false;
     }
   }
   // -----------------------------------------------------------------------
@@ -5486,10 +5563,15 @@ var BaichuanHttpStreamServer = class extends EventEmitter3 {
       // Force a known frame rate on raw H.264 input so the muxer gets valid PTS/DTS.
       "-r",
       String(this.inputFps),
+      // `+genpts` generates uniform PTS from `-r` for raw Annex-B input. We
+      // deliberately do NOT pass `-use_wallclock_as_timestamps 1`: that
+      // overrides the generated PTS with the host wallclock at frame ARRIVAL
+      // time, and the network stream is bursty so the resulting PTS is
+      // uneven. With `-r` forcing a target rate downstream, ffmpeg then
+      // drops/duplicates frames to match — visible as the periodic stutter
+      // reported on local-restreamer recordings (issue #11).
       "-fflags",
       "+genpts",
-      "-use_wallclock_as_timestamps",
-      "1",
       "-f",
       "h264",
       // Input format (H.264 Annex-B)
@@ -6166,7 +6248,194 @@ var BaichuanMjpegServer = class extends EventEmitter5 {
 };
 
 // src/baichuan/stream/BaichuanWebRTCServer.ts
+import { EventEmitter as EventEmitter7 } from "events";
+
+// src/baichuan/stream/AacToOpusTranscoder.ts
+import { spawn as spawn7 } from "child_process";
+import { createSocket } from "dgram";
 import { EventEmitter as EventEmitter6 } from "events";
+var AacToOpusTranscoder = class extends EventEmitter6 {
+  opts;
+  socket = null;
+  ffmpeg = null;
+  port = 0;
+  starting = null;
+  stopped = false;
+  constructor(options = {}) {
+    super();
+    this.opts = {
+      ffmpegPath: options.ffmpegPath ?? "ffmpeg",
+      opusSampleRate: options.opusSampleRate ?? 48e3,
+      opusChannels: options.opusChannels ?? 2,
+      opusFrameMs: options.opusFrameMs ?? 20,
+      opusBitrate: options.opusBitrate ?? 64e3,
+      ...options.logger !== void 0 ? { logger: options.logger } : {}
+    };
+  }
+  log(level, message) {
+    this.opts.logger?.(level, `[AacToOpusTranscoder] ${message}`);
+  }
+  /**
+   * Allocate the UDP loopback socket and spawn ffmpeg. Must be awaited before
+   * the first call to `feedAac`.
+   */
+  async start() {
+    if (this.starting) return this.starting;
+    this.starting = this._start();
+    return this.starting;
+  }
+  async _start() {
+    if (this.stopped) throw new Error("transcoder stopped");
+    this.socket = createSocket("udp4");
+    await new Promise((resolve, reject) => {
+      this.socket.once("error", reject);
+      this.socket.bind({ address: "127.0.0.1", port: 0 }, () => {
+        this.socket.removeListener("error", reject);
+        this.port = this.socket.address().port;
+        resolve();
+      });
+    });
+    this.log("info", `UDP loopback bound on 127.0.0.1:${this.port}`);
+    this.socket.on("message", (rtpPacket) => this.handleRtp(rtpPacket));
+    this.socket.on("error", (err) => {
+      this.log("error", `socket error: ${err.message}`);
+      this.emit("error", err);
+    });
+    const args = [
+      "-loglevel",
+      "warning",
+      "-fflags",
+      "nobuffer",
+      "-f",
+      "aac",
+      "-i",
+      "pipe:0",
+      "-c:a",
+      "libopus",
+      "-ar",
+      String(this.opts.opusSampleRate),
+      "-ac",
+      String(this.opts.opusChannels),
+      "-application",
+      "audio",
+      "-frame_duration",
+      String(this.opts.opusFrameMs),
+      "-b:a",
+      String(this.opts.opusBitrate),
+      // Important: disable VBR so the output rate matches the configured
+      // bitrate consistently — easier on the browser jitter buffer.
+      "-vbr",
+      "off",
+      "-f",
+      "rtp",
+      `rtp://127.0.0.1:${this.port}`
+    ];
+    this.log("info", `spawning ffmpeg with: ${this.opts.ffmpegPath} ${args.join(" ")}`);
+    this.ffmpeg = spawn7(this.opts.ffmpegPath, args, {
+      stdio: ["pipe", "ignore", "pipe"]
+    });
+    this.ffmpeg.on("error", (err) => {
+      this.log("error", `ffmpeg spawn error: ${err.message}`);
+      this.emit("error", err);
+    });
+    this.ffmpeg.stderr?.on("data", (chunk) => {
+      this.log("debug", `ffmpeg stderr: ${chunk.toString().trim()}`);
+    });
+    this.ffmpeg.on("exit", (code) => {
+      this.log(code === 0 ? "info" : "warn", `ffmpeg exited code=${code}`);
+      this.emit("exit", code);
+    });
+  }
+  /**
+   * Feed one or more concatenated ADTS AAC frames to ffmpeg. Returns the
+   * number of bytes written. Safe to call before a frame is fully buffered.
+   */
+  feedAac(buf) {
+    if (this.stopped) return false;
+    if (!this.ffmpeg?.stdin || !this.ffmpeg.stdin.writable) {
+      this.log("debug", "drop AAC frame \u2014 ffmpeg stdin not writable");
+      return false;
+    }
+    return this.ffmpeg.stdin.write(buf);
+  }
+  /**
+   * Close stdin (ffmpeg exits cleanly on EOF) and tear down the UDP socket.
+   */
+  async stop() {
+    if (this.stopped) return;
+    this.stopped = true;
+    try {
+      this.ffmpeg?.stdin?.end();
+    } catch {
+    }
+    if (this.ffmpeg && this.ffmpeg.exitCode === null) {
+      await new Promise((resolve) => {
+        const t = setTimeout(() => {
+          this.ffmpeg?.kill("SIGKILL");
+          resolve();
+        }, 500);
+        this.ffmpeg?.once("exit", () => {
+          clearTimeout(t);
+          resolve();
+        });
+      });
+    }
+    this.ffmpeg = null;
+    if (this.socket) {
+      try {
+        this.socket.close();
+      } catch {
+      }
+      this.socket = null;
+    }
+    this.log("info", "stopped");
+  }
+  /**
+   * Parse an RTP packet ffmpeg emitted on the loopback socket and surface
+   * its Opus payload. RTP header layout (RFC 3550):
+   *
+   *   0                   1                   2                   3
+   *   0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+   *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+   *  |V=2|P|X|  CC   |M|     PT      |       sequence number         |
+   *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+   *  |                           timestamp                           |
+   *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+   *  |           synchronization source (SSRC) identifier            |
+   *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+   *
+   * We honor the CC, X (extension) and P (padding) bits to compute the
+   * payload offset / length correctly even if ffmpeg ever emits those.
+   */
+  handleRtp(packet) {
+    if (packet.length < 12) return;
+    const b0 = packet[0];
+    const b1 = packet[1];
+    const version = b0 >> 6;
+    if (version !== 2) return;
+    const padding = (b0 & 32) !== 0;
+    const extension = (b0 & 16) !== 0;
+    const csrcCount = b0 & 15;
+    const marker = (b1 & 128) !== 0;
+    let offset = 12 + csrcCount * 4;
+    if (extension) {
+      if (packet.length < offset + 4) return;
+      const extLen = packet.readUInt16BE(offset + 2);
+      offset += 4 + extLen * 4;
+    }
+    let end = packet.length;
+    if (padding) {
+      const pad = packet[packet.length - 1];
+      end -= pad;
+    }
+    if (offset >= end) return;
+    const timestamp = packet.readUInt32BE(4);
+    const payload = Buffer.from(packet.subarray(offset, end));
+    this.emit("packet", { payload, timestamp, marker });
+  }
+};
+
+// src/baichuan/stream/BaichuanWebRTCServer.ts
 function parseAnnexBNalUnits(annexB) {
   const nalUnits = [];
   let offset = 0;
@@ -6201,7 +6470,7 @@ function getH264NalType(nalUnit) {
 function getH265NalType2(nalUnit) {
   return nalUnit[0] >> 1 & 63;
 }
-var BaichuanWebRTCServer = class extends EventEmitter6 {
+var BaichuanWebRTCServer = class extends EventEmitter7 {
   options;
   sessions = /* @__PURE__ */ new Map();
   sessionIdCounter = 0;
@@ -6439,6 +6708,14 @@ Error: ${err}`
       }
       session.dataChannel = null;
     }
+    if (session.audioTranscoder) {
+      try {
+        await session.audioTranscoder.stop();
+      } catch (err) {
+        this.log("debug", `Error stopping audio transcoder: ${err}`);
+      }
+      session.audioTranscoder = null;
+    }
     if (session.cleanup) {
       session.cleanup();
     }
@@ -6565,6 +6842,17 @@ Error: ${err}`
         }
         if (frame.audio) {
           session.stats.audioFrames++;
+          if (session.stats.audioFrames === 1) {
+            const head = frame.data && frame.data.length > 0 ? frame.data.subarray(0, Math.min(8, frame.data.length)).toString("hex") : "(empty)";
+            this.log(
+              "info",
+              `First audio frame for ${session.id}: codec=${frame.codec ?? "?"} bytes=${frame.data?.length ?? 0} head=${head}`
+            );
+          }
+          if (this.options.ffmpegPath !== "" && frame.data && frame.data.length > 0) {
+            await this.ensureAudioTranscoder(session, werift);
+            session.audioTranscoder?.feedAac(frame.data);
+          }
         } else {
           if (frame.data) {
             if (!session.videoCodec && frame.videoType) {
@@ -6635,7 +6923,7 @@ Error: ${err}`
             if (now - lastLogTime >= 5e3) {
               this.log(
                 "debug",
-                `WebRTC session ${session.id} [${session.videoCodec}]: sent ${session.stats.videoFrames} frames, ${packetsSentSinceLastLog} packets, ${Math.round(session.stats.bytesSent / 1024)} KB`
+                `WebRTC session ${session.id} [${session.videoCodec}]: sent ${session.stats.videoFrames} video frames, ${packetsSentSinceLastLog} packets, ${Math.round(session.stats.bytesSent / 1024)} KB | audio frames=${session.stats.audioFrames}`
               );
               lastLogTime = now;
               packetsSentSinceLastLog = 0;
@@ -6651,6 +6939,77 @@ Error: ${err}`
     }
     this.log("info", `Native stream ended for session ${session.id}`);
   }
+  /**
+   * Lazily start the AAC → Opus transcoder for `session` and wire it to the
+   * audio RTP track. ffmpeg writes RTP-formatted Opus packets back to a UDP
+   * loopback the transcoder owns; we strip the RTP header and rewrap the
+   * Opus payload with our audioTrack's SSRC so the browser receives a
+   * coherent stream.
+   */
+  async ensureAudioTranscoder(session, werift) {
+    if (session.audioTranscoder !== void 0) return;
+    const { RtpPacket, RtpHeader } = werift;
+    const ssrc = session.audioTrack?.ssrc ?? Math.floor(Math.random() * 4294967295);
+    const transcoder = new AacToOpusTranscoder({
+      ...this.options.ffmpegPath ? { ffmpegPath: this.options.ffmpegPath } : {},
+      logger: (level, msg) => this.log(level, msg)
+    });
+    session.audioRtpSequence = Math.floor(Math.random() * 65535);
+    session.audioRtpTimestampBase = 0;
+    transcoder.on("packet", ({ payload, timestamp, marker }) => {
+      try {
+        if (session.audioRtpTimestampBase === void 0 || session.audioRtpTimestampBase === 0) {
+          session.audioRtpTimestampBase = timestamp;
+        }
+        const localTs = timestamp - session.audioRtpTimestampBase >>> 0;
+        const seq = session.audioRtpSequence;
+        session.audioRtpSequence = seq + 1 & 65535;
+        const header = new RtpHeader({
+          version: 2,
+          padding: false,
+          extension: false,
+          marker,
+          // Werift assigns 111 to Opus by default in the receiver SDP, but it
+          // also accepts other PTs. Use 111 for compatibility with the offer
+          // we generated earlier.
+          payloadType: 111,
+          sequenceNumber: seq,
+          timestamp: localTs,
+          ssrc
+        });
+        const rtp = new RtpPacket(header, payload);
+        session.audioTrack?.writeRtp(rtp);
+        if (!session.audioStartedLogged) {
+          session.audioStartedLogged = true;
+          this.log(
+            "info",
+            `Audio RTP started for ${session.id} (PT=111, ssrc=${ssrc})`
+          );
+        }
+      } catch (err) {
+        this.log(
+          "warn",
+          `audio writeRtp failed for ${session.id}: ${err.message}`
+        );
+      }
+    });
+    transcoder.on("error", (err) => {
+      this.log("error", `audio transcoder error for ${session.id}: ${err.message}`);
+    });
+    transcoder.on("exit", (code) => {
+      this.log("info", `audio transcoder exited (${code}) for ${session.id}`);
+    });
+    try {
+      await transcoder.start();
+      session.audioTranscoder = transcoder;
+    } catch (err) {
+      this.log(
+        "error",
+        `failed to start audio transcoder for ${session.id}: ${err.message}`
+      );
+      session.audioTranscoder = null;
+    }
+  }
   /**
    * Send H.264 frame via RTP media track
    * Returns the number of RTP packets sent
@@ -6938,21 +7297,21 @@ Error: ${err}`
         `Sending ${codec} frame ${frameNumber}: ${packet.length} bytes, keyframe=${isKeyframe}`
       );
     }
-    const MAX_CHUNK_SIZE = 16e3;
+    const CHUNK_HEADER_LEN = 4;
+    const MAX_PAYLOAD_PER_CHUNK = 16e3 - CHUNK_HEADER_LEN;
     try {
-      if (packet.length <= MAX_CHUNK_SIZE) {
-        session.videoDataChannel.send(packet);
-      } else {
-        const totalChunks = Math.ceil(packet.length / MAX_CHUNK_SIZE);
-        for (let i = 0; i < totalChunks; i++) {
-          const start = i * MAX_CHUNK_SIZE;
-          const end = Math.min(start + MAX_CHUNK_SIZE, packet.length);
-          const chunk = packet.subarray(start, end);
-          const chunkHeader = Buffer.alloc(2);
-          chunkHeader.writeUInt8(i, 0);
-          chunkHeader.writeUInt8(totalChunks, 1);
-          session.videoDataChannel.send(Buffer.concat([chunkHeader, chunk]));
-        }
+      const totalChunks = Math.max(
+        1,
+        Math.ceil(packet.length / MAX_PAYLOAD_PER_CHUNK)
+      );
+      for (let i = 0; i < totalChunks; i++) {
+        const start = i * MAX_PAYLOAD_PER_CHUNK;
+        const end = Math.min(start + MAX_PAYLOAD_PER_CHUNK, packet.length);
+        const chunk = packet.subarray(start, end);
+        const chunkHeader = Buffer.alloc(CHUNK_HEADER_LEN);
+        chunkHeader.writeUInt16BE(i, 0);
+        chunkHeader.writeUInt16BE(totalChunks, 2);
+        session.videoDataChannel.send(Buffer.concat([chunkHeader, chunk]));
       }
       return true;
     } catch (err) {
@@ -7103,12 +7462,12 @@ Error: ${err}`
 };
 
 // src/baichuan/stream/BaichuanHlsServer.ts
-import { EventEmitter as EventEmitter7 } from "events";
+import { EventEmitter as EventEmitter8 } from "events";
 import fs from "fs";
 import fsp from "fs/promises";
 import os from "os";
 import path from "path";
-import { spawn as spawn7 } from "child_process";
+import { spawn as spawn8 } from "child_process";
 function parseAnnexBNalUnits2(data) {
   const units = [];
   const len = data.length;
@@ -7180,7 +7539,7 @@ function getNalTypes(codec, annexB) {
     }
   });
 }
-var BaichuanHlsServer = class extends EventEmitter7 {
+var BaichuanHlsServer = class extends EventEmitter8 {
   api;
   channel;
   profile;
@@ -7537,10 +7896,17 @@ var BaichuanHlsServer = class extends EventEmitter7 {
       "-hide_banner",
       "-loglevel",
       "warning",
+      // `+genpts` makes ffmpeg generate uniform PTS from the declared `-r`
+      // when the raw H.264/H.265 input has none. We deliberately do NOT use
+      // `-use_wallclock_as_timestamps 1` here: it replaces the generated
+      // PTS with the host wallclock at FRAME ARRIVAL time, and because the
+      // camera ships frames in bursty network reads, the resulting PTS
+      // sequence is uneven. With `-r 25` (or anything else) forcing a
+      // target rate downstream, ffmpeg then drops/duplicates frames to
+      // match — visible as the periodic stutter / pulsing reported on
+      // local-restreamer recordings (issue #11).
       "-fflags",
       "+genpts",
-      "-use_wallclock_as_timestamps",
-      "1",
       "-r",
       "25",
       "-f",
@@ -7575,7 +7941,7 @@ var BaichuanHlsServer = class extends EventEmitter7 {
       this.segmentPattern,
       this.playlistPath
     );
-    const p = spawn7(this.ffmpegPath, args, {
+    const p = spawn8(this.ffmpegPath, args, {
       stdio: ["pipe", "ignore", "pipe"]
     });
     p.on("error", (err) => {
@@ -7598,10 +7964,10 @@ var BaichuanHlsServer = class extends EventEmitter7 {
 };
 
 // src/multifocal/compositeRtspServer.ts
-import { EventEmitter as EventEmitter8 } from "events";
-import { spawn as spawn8 } from "child_process";
+import { EventEmitter as EventEmitter9 } from "events";
+import { spawn as spawn9 } from "child_process";
 import * as net2 from "net";
-var CompositeRtspServer = class extends EventEmitter8 {
+var CompositeRtspServer = class extends EventEmitter9 {
   options;
   compositeStream = null;
   rtspServer = null;
@@ -7706,7 +8072,7 @@ var CompositeRtspServer = class extends EventEmitter8 {
     this.logger.log?.(
       `[CompositeRtspServer] Starting ffmpeg RTSP server: ${ffmpegArgs.join(" ")}`
     );
-    this.ffmpegProcess = spawn8("ffmpeg", ffmpegArgs, {
+    this.ffmpegProcess = spawn9("ffmpeg", ffmpegArgs, {
       stdio: ["pipe", "pipe", "pipe"]
     });
     this.ffmpegProcess.on("error", (error) => {
@@ -7814,6 +8180,86 @@ var CompositeRtspServer = class extends EventEmitter8 {
     return this.connectedClients.size;
   }
 };
+
+// src/reolink/baichuan/utils/motionZone.ts
+function decodeMotionScopeBitmap(valueTable, columns, rows, width = columns, height = rows) {
+  const trimmed = valueTable.trim().replace(/[^A-Za-z0-9+/=]/g, "");
+  const bytes = base64DecodeToBytes(trimmed);
+  const totalBits = columns * rows;
+  if (bytes.length * 8 < totalBits) {
+    throw new Error(
+      `valueTable too short: have ${bytes.length * 8} bits, need ${totalBits}`
+    );
+  }
+  const w = Math.min(width, columns);
+  const h = Math.min(height, rows);
+  const cells = new Array(w * h);
+  for (let r = 0; r < h; r++) {
+    for (let c = 0; c < w; c++) {
+      const bitIndex = r * columns + c;
+      const byteIdx = bitIndex >> 3;
+      const bitIdx = 7 - (bitIndex & 7);
+      cells[r * w + c] = (bytes[byteIdx] ?? 0) >> bitIdx & 1 ? true : false;
+    }
+  }
+  return { width: w, height: h, columns, rows, cells };
+}
+function encodeMotionScopeBitmap(scope) {
+  const bytes = new Uint8Array(Math.ceil(scope.columns * scope.rows / 8));
+  for (let r = 0; r < scope.height; r++) {
+    for (let c = 0; c < scope.width; c++) {
+      const on = scope.cells[r * scope.width + c];
+      if (!on) continue;
+      const bitIndex = r * scope.columns + c;
+      const byteIdx = bitIndex >> 3;
+      const bitIdx = 7 - (bitIndex & 7);
+      bytes[byteIdx] = (bytes[byteIdx] ?? 0) | 1 << bitIdx;
+    }
+  }
+  return base64EncodeBytes(bytes);
+}
+function fullCoverageScope(columns, rows, width = columns, height = rows) {
+  return {
+    width,
+    height,
+    columns,
+    rows,
+    cells: new Array(width * height).fill(true)
+  };
+}
+var B64_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+function base64EncodeBytes(bytes) {
+  let out = "";
+  for (let i = 0; i < bytes.length; i += 3) {
+    const b0 = bytes[i] ?? 0;
+    const b1 = bytes[i + 1] ?? 0;
+    const b2 = bytes[i + 2] ?? 0;
+    out += B64_ALPHABET[b0 >> 2];
+    out += B64_ALPHABET[(b0 & 3) << 4 | b1 >> 4];
+    out += i + 1 < bytes.length ? B64_ALPHABET[(b1 & 15) << 2 | b2 >> 6] : "=";
+    out += i + 2 < bytes.length ? B64_ALPHABET[b2 & 63] : "=";
+  }
+  return out;
+}
+function base64DecodeToBytes(b64) {
+  const padded = b64.padEnd(Math.ceil(b64.length / 4) * 4, "=");
+  const stripped = padded.replace(/=+$/, "");
+  const out = new Uint8Array(Math.floor(stripped.length * 6 / 8));
+  let bits = 0;
+  let value = 0;
+  let outIdx = 0;
+  for (const ch of stripped) {
+    const idx = B64_ALPHABET.indexOf(ch);
+    if (idx < 0) continue;
+    value = value << 6 | idx;
+    bits += 6;
+    if (bits >= 8) {
+      bits -= 8;
+      out[outIdx++] = value >> bits & 255;
+    }
+  }
+  return out.subarray(0, outIdx);
+}
 export {
   AesStreamDecryptor,
   AutodiscoveryClient,
@@ -7860,6 +8306,7 @@ export {
   BC_CMD_ID_GET_AUDIO_CFG,
   BC_CMD_ID_GET_AUDIO_TASK,
   BC_CMD_ID_GET_AUTO_FOCUS,
+  BC_CMD_ID_GET_AUTO_REBOOT,
   BC_CMD_ID_GET_BATTERY_INFO,
   BC_CMD_ID_GET_BATTERY_INFO_LIST,
   BC_CMD_ID_GET_DAY_NIGHT_THRESHOLD,
@@ -7867,6 +8314,8 @@ export {
   BC_CMD_ID_GET_DING_DONG_CFG,
   BC_CMD_ID_GET_DING_DONG_LIST,
   BC_CMD_ID_GET_DING_DONG_SILENT,
+  BC_CMD_ID_GET_DST,
+  BC_CMD_ID_GET_EMAIL,
   BC_CMD_ID_GET_EMAIL_TASK,
   BC_CMD_ID_GET_ENC,
   BC_CMD_ID_GET_FTP_TASK,
@@ -7874,6 +8323,7 @@ export {
   BC_CMD_ID_GET_KIT_AP_CFG,
   BC_CMD_ID_GET_LED_STATE,
   BC_CMD_ID_GET_MOTION_ALARM,
+  BC_CMD_ID_GET_NTP,
   BC_CMD_ID_GET_ONLINE_USER_LIST,
   BC_CMD_ID_GET_OSD_DATETIME,
   BC_CMD_ID_GET_PIR_INFO,
@@ -7890,6 +8340,7 @@ export {
   BC_CMD_ID_GET_SUPPORT,
   BC_CMD_ID_GET_SYSTEM_GENERAL,
   BC_CMD_ID_GET_TIMELAPSE_CFG,
+  BC_CMD_ID_GET_VERSION_INFO,
   BC_CMD_ID_GET_VIDEO_INPUT,
   BC_CMD_ID_GET_WHITE_LED,
   BC_CMD_ID_GET_WIFI,
@@ -7913,18 +8364,24 @@ export {
   BC_CMD_ID_SET_AUDIO_CFG,
   BC_CMD_ID_SET_AUDIO_TASK,
   BC_CMD_ID_SET_AUTO_FOCUS,
+  BC_CMD_ID_SET_AUTO_REBOOT,
   BC_CMD_ID_SET_DAY_NIGHT_THRESHOLD,
   BC_CMD_ID_SET_DING_DONG_CFG,
   BC_CMD_ID_SET_DING_DONG_SILENT,
+  BC_CMD_ID_SET_DST,
+  BC_CMD_ID_SET_EMAIL,
   BC_CMD_ID_SET_EMAIL_TASK,
   BC_CMD_ID_SET_ENC,
   BC_CMD_ID_SET_LED_STATE,
   BC_CMD_ID_SET_MOTION_ALARM,
+  BC_CMD_ID_SET_NTP,
+  BC_CMD_ID_SET_OSD_DATETIME,
   BC_CMD_ID_SET_PIR_INFO,
   BC_CMD_ID_SET_PRIVACY_MASK,
   BC_CMD_ID_SET_PUSH_TASK,
   BC_CMD_ID_SET_RECORD,
   BC_CMD_ID_SET_RECORD_CFG,
+  BC_CMD_ID_SET_SYSTEM_GENERAL,
   BC_CMD_ID_SET_VIDEO_INPUT,
   BC_CMD_ID_SET_WHITE_LED_STATE,
   BC_CMD_ID_SET_WHITE_LED_TASK,
@@ -7934,6 +8391,7 @@ export {
   BC_CMD_ID_TALK_ABILITY,
   BC_CMD_ID_TALK_CONFIG,
   BC_CMD_ID_TALK_RESET,
+  BC_CMD_ID_TEST_EMAIL,
   BC_CMD_ID_UDP_KEEP_ALIVE,
   BC_CMD_ID_VIDEO,
   BC_CMD_ID_VIDEO_STOP,
@@ -8028,6 +8486,7 @@ export {
   decideSleepInferenceTransition,
   decideVideoclipTranscodeMode,
   decodeHeader,
+  decodeMotionScopeBitmap,
   deriveAesKey,
   detectIosClient,
   detectVideoCodecFromNal,
@@ -8040,6 +8499,7 @@ export {
   discoverViaUdpBroadcast,
   discoverViaUdpDirect,
   encodeHeader,
+  encodeMotionScopeBitmap,
   ensureXmlHeader,
   extractH264ParamSetsFromAccessUnit,
   extractH265ParamSetsFromAccessUnit,
@@ -8048,6 +8508,7 @@ export {
   extractVpsFromAnnexB,
   flattenAbilitiesForChannel,
   formatMjpegFrame,
+  fullCoverageScope,
   getConstructedVideoStreamOptions,
   getGlobalLogger,
   getH265NalType,
@@ -8091,6 +8552,7 @@ export {
   splitAnnexBToNals,
   splitAnnexBToNalPayloads2 as splitH265AnnexBToNalPayloads,
   testChannelStreams,
+  upsertXmlTag,
   xmlEscape,
   xmlIndicatesFloodlight,
   zipDirectory