@apocaliss92/nodelink-js 0.4.31 → 0.4.33

package/dist/index.d.cts

@@ -5702,6 +5702,13 @@ declare class ReolinkBaichuanApi {
      * Once closed, the API instance should not be reused.
      */
     private _closed;
+    /**
+     * Off-handle for the auto-bridge between the global email-push bus
+     * and this api's `simpleEventListeners`. Set in the constructor
+     * when `emailPushCameraId` is provided; released in `close()`.
+     * `undefined` means no bridge was requested for this api.
+     */
+    private emailPushAutoBridgeOff;
     /**
      * Socket pool with tag-based allocation strategy.
      * Tags determine which sockets are shared vs dedicated:
@@ -5872,6 +5879,21 @@ declare class ReolinkBaichuanApi {
     private simpleEventWatchdogLastRecoveryAt;
     private readonly simpleEventWatchdogIntervalMs;
     private readonly simpleEventWatchdogSilenceThresholdMs;
+    /**
+     * Whether the silence-based resubscribe path of the watchdog is
+     * enabled. On UDP (battery cameras) silence is the *normal* state
+     * while the device sleeps — firing `ensureSimpleEventSubscribed`
+     * every 5 minutes wakes the camera on every tick, drains the
+     * battery, and is observably wrong because the cam emits a
+     * sleep/awake push when it actually wakes for motion.
+     *
+     * Defaults: `false` on UDP, `true` on TCP / `auto`. The subscription-
+     * failed recovery path (Case 2) stays active regardless — it only
+     * runs when the connection is alive, doesn't wake anyone, and is
+     * useful on every transport when the initial subscribe call lost
+     * the response packet.
+     */
+    private eventWatchdogSilenceResubscribeEnabled;
     private statePollingInterval;
     private udpSleepInferenceInterval;
     private readonly udpLastInferredSleepStateByChannel;
@@ -6216,6 +6238,37 @@ declare class ReolinkBaichuanApi {
          * out on TCP, or `true` to opt in on UDP (not recommended).
          */
         enableEventResubscribe?: boolean;
+        /**
+         * When set, the api auto-subscribes to the global email-push bus
+         * and translates each matching delivery (`event.cameraId ===
+         * emailPushCameraId`) into `dispatchSimpleEvent` — so any
+         * consumer registered via `api.onSimpleEvent(...)` receives
+         * native Baichuan push AND SMTP-delivered motion through the
+         * exact same stream, with no second subscription needed. The
+         * bridge survives TCP transient disconnects (it's a JS-level
+         * fan-out, not a network operation) and is released
+         * automatically by `close()`.
+         *
+         * Pair with `emailPushChannel` when the camera lives on a
+         * non-zero channel (NVR children, multi-channel cams).
+         */
+        emailPushCameraId?: string;
+        /** Channel reported on the synthesised event. Default 0. */
+        emailPushChannel?: number;
+        /**
+         * Enable the watchdog's silence-based resubscribe path (Case 1
+         * in `simpleEventWatchdogTick`): when no event arrives for 5
+         * minutes the lib forces an `ensureSimpleEventSubscribed` call.
+         *
+         * Default: `true` for non-UDP transports (TCP / `auto`),
+         * `false` for UDP. On UDP (battery cams) silence is the normal
+         * state while the device sleeps — running this path wakes the
+         * cam every 5 minutes for no real benefit, since the cam emits
+         * its own sleep/awake push when it actually wakes for motion.
+         * The subscription-failed recovery path (Case 2) stays active
+         * regardless and is safe on every transport.
+         */
+        enableEventWatchdogSilenceResubscribe?: boolean;
     });
     /**
      * CGI forward: fetch RTSP URL for a channel via `GetRtspUrl`.

package/dist/index.d.ts

@@ -6687,6 +6687,13 @@ export declare class ReolinkBaichuanApi {
      * Once closed, the API instance should not be reused.
      */
     private _closed;
+    /**
+     * Off-handle for the auto-bridge between the global email-push bus
+     * and this api's `simpleEventListeners`. Set in the constructor
+     * when `emailPushCameraId` is provided; released in `close()`.
+     * `undefined` means no bridge was requested for this api.
+     */
+    private emailPushAutoBridgeOff;
     /**
      * Socket pool with tag-based allocation strategy.
      * Tags determine which sockets are shared vs dedicated:
@@ -6857,6 +6864,21 @@ export declare class ReolinkBaichuanApi {
     private simpleEventWatchdogLastRecoveryAt;
     private readonly simpleEventWatchdogIntervalMs;
     private readonly simpleEventWatchdogSilenceThresholdMs;
+    /**
+     * Whether the silence-based resubscribe path of the watchdog is
+     * enabled. On UDP (battery cameras) silence is the *normal* state
+     * while the device sleeps — firing `ensureSimpleEventSubscribed`
+     * every 5 minutes wakes the camera on every tick, drains the
+     * battery, and is observably wrong because the cam emits a
+     * sleep/awake push when it actually wakes for motion.
+     *
+     * Defaults: `false` on UDP, `true` on TCP / `auto`. The subscription-
+     * failed recovery path (Case 2) stays active regardless — it only
+     * runs when the connection is alive, doesn't wake anyone, and is
+     * useful on every transport when the initial subscribe call lost
+     * the response packet.
+     */
+    private eventWatchdogSilenceResubscribeEnabled;
     private statePollingInterval;
     private udpSleepInferenceInterval;
     private readonly udpLastInferredSleepStateByChannel;
@@ -7201,6 +7223,37 @@ export declare class ReolinkBaichuanApi {
          * out on TCP, or `true` to opt in on UDP (not recommended).
          */
         enableEventResubscribe?: boolean;
+        /**
+         * When set, the api auto-subscribes to the global email-push bus
+         * and translates each matching delivery (`event.cameraId ===
+         * emailPushCameraId`) into `dispatchSimpleEvent` — so any
+         * consumer registered via `api.onSimpleEvent(...)` receives
+         * native Baichuan push AND SMTP-delivered motion through the
+         * exact same stream, with no second subscription needed. The
+         * bridge survives TCP transient disconnects (it's a JS-level
+         * fan-out, not a network operation) and is released
+         * automatically by `close()`.
+         *
+         * Pair with `emailPushChannel` when the camera lives on a
+         * non-zero channel (NVR children, multi-channel cams).
+         */
+        emailPushCameraId?: string;
+        /** Channel reported on the synthesised event. Default 0. */
+        emailPushChannel?: number;
+        /**
+         * Enable the watchdog's silence-based resubscribe path (Case 1
+         * in `simpleEventWatchdogTick`): when no event arrives for 5
+         * minutes the lib forces an `ensureSimpleEventSubscribed` call.
+         *
+         * Default: `true` for non-UDP transports (TCP / `auto`),
+         * `false` for UDP. On UDP (battery cams) silence is the normal
+         * state while the device sleeps — running this path wakes the
+         * cam every 5 minutes for no real benefit, since the cam emits
+         * its own sleep/awake push when it actually wakes for motion.
+         * The subscription-failed recovery path (Case 2) stays active
+         * regardless and is safe on every transport.
+         */
+        enableEventWatchdogSilenceResubscribe?: boolean;
     });
     /**
      * CGI forward: fetch RTSP URL for a channel via `GetRtspUrl`.

package/dist/index.js

@@ -65,7 +65,7 @@ import {
   setEmailPushCameraResolver,
   setGlobalLogger,
   xmlIndicatesFloodlight
-} from "./chunk-XVFCEFM6.js";
+} from "./chunk-OZL6C2YJ.js";
 import {
   ReolinkCgiApi,
   ReolinkHttpClient,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apocaliss92/nodelink-js",
-  "version": "0.4.31",
+  "version": "0.4.33",
   "description": "TypeScript library implementing Reolink Baichuan protocol (control + streaming) with CGI and RTSP helpers. Full TypeScript support with comprehensive type definitions.",
   "license": "MIT",
   "author": "",