@apocaliss92/nodelink-js 0.4.20 → 0.4.21

package/dist/index.d.cts

@@ -5519,6 +5519,25 @@ declare class ReolinkBaichuanApi {
     private simpleEventResubscribeTimer;
     private simpleEventResubscribeInFlight;
     private readonly simpleEventResubscribeIntervalMs;
+    /**
+     * Default `true` for non-UDP transports (TCP / `auto`), `false` for UDP.
+     *
+     * On TCP the periodic 5-min `subscribeEvents` renewal is cheap belt-and-
+     * braces for firmwares that silently drop the push subscription.
+     *
+     * On UDP (battery cameras) every renewal sends cmd_id 31 which wakes
+     * the device, driving an exact-5-minute sleep/awake cycle visible
+     * downstream in MQTT / Home Assistant (continuation of issue #18). The
+     * reactive `simpleEventWatchdog` (10s tick, 5 min silence threshold)
+     * already recovers silent-drop cases without periodic wakes, so the
+     * renewal is disabled by default for UDP.
+     *
+     * `startSimpleEventResubscribeTimer` also re-checks the live transport
+     * before arming the timer, so callers that pick `transport: "auto"` and
+     * end up on UDP at runtime get the safer behaviour even if the flag
+     * was left default-on.
+     */
+    private eventResubscribeEnabled;
     private simpleEventWatchdogTimer;
     private simpleEventLastReceivedAt;
     private simpleEventWatchdogRecoveryAttempts;
@@ -5854,6 +5873,21 @@ declare class ReolinkBaichuanApi {
          * even then the lib skips the poll on UDP transport.
          */
         enableSessionGuard?: boolean;
+        /**
+         * Enable proactive simple-event subscription renewal: every 5 minutes
+         * the lib re-sends `subscribeEvents` (cmd_id 31) so firmwares that
+         * silently drop the push subscription keep delivering events.
+         *
+         * Default: `true` for non-UDP transports (TCP / `auto`), `false` for
+         * UDP (battery cameras). The renewal is harmless on TCP and useful
+         * as belt-and-braces for the rare firmwares that drop subscriptions
+         * without producing event silence. On UDP every renewal wakes the
+         * device, driving an exact 5-minute sleep/awake cycle (continuation
+         * of issue #18); the reactive `simpleEventWatchdog` covers the same
+         * failure mode without the wake-up. Pass `false` explicitly to opt
+         * out on TCP, or `true` to opt in on UDP (not recommended).
+         */
+        enableEventResubscribe?: boolean;
     });
     /**
      * CGI forward: fetch RTSP URL for a channel via `GetRtspUrl`.

package/dist/index.d.ts

@@ -6434,6 +6434,25 @@ export declare class ReolinkBaichuanApi {
     private simpleEventResubscribeTimer;
     private simpleEventResubscribeInFlight;
     private readonly simpleEventResubscribeIntervalMs;
+    /**
+     * Default `true` for non-UDP transports (TCP / `auto`), `false` for UDP.
+     *
+     * On TCP the periodic 5-min `subscribeEvents` renewal is cheap belt-and-
+     * braces for firmwares that silently drop the push subscription.
+     *
+     * On UDP (battery cameras) every renewal sends cmd_id 31 which wakes
+     * the device, driving an exact-5-minute sleep/awake cycle visible
+     * downstream in MQTT / Home Assistant (continuation of issue #18). The
+     * reactive `simpleEventWatchdog` (10s tick, 5 min silence threshold)
+     * already recovers silent-drop cases without periodic wakes, so the
+     * renewal is disabled by default for UDP.
+     *
+     * `startSimpleEventResubscribeTimer` also re-checks the live transport
+     * before arming the timer, so callers that pick `transport: "auto"` and
+     * end up on UDP at runtime get the safer behaviour even if the flag
+     * was left default-on.
+     */
+    private eventResubscribeEnabled;
     private simpleEventWatchdogTimer;
     private simpleEventLastReceivedAt;
     private simpleEventWatchdogRecoveryAttempts;
@@ -6769,6 +6788,21 @@ export declare class ReolinkBaichuanApi {
          * even then the lib skips the poll on UDP transport.
          */
         enableSessionGuard?: boolean;
+        /**
+         * Enable proactive simple-event subscription renewal: every 5 minutes
+         * the lib re-sends `subscribeEvents` (cmd_id 31) so firmwares that
+         * silently drop the push subscription keep delivering events.
+         *
+         * Default: `true` for non-UDP transports (TCP / `auto`), `false` for
+         * UDP (battery cameras). The renewal is harmless on TCP and useful
+         * as belt-and-braces for the rare firmwares that drop subscriptions
+         * without producing event silence. On UDP every renewal wakes the
+         * device, driving an exact 5-minute sleep/awake cycle (continuation
+         * of issue #18); the reactive `simpleEventWatchdog` covers the same
+         * failure mode without the wake-up. Pass `false` explicitly to opt
+         * out on TCP, or `true` to opt in on UDP (not recommended).
+         */
+        enableEventResubscribe?: boolean;
     });
     /**
      * CGI forward: fetch RTSP URL for a channel via `GetRtspUrl`.

package/dist/index.js

@@ -45,7 +45,7 @@ import {
   parseSupportXml,
   setGlobalLogger,
   xmlIndicatesFloodlight
-} from "./chunk-XUL2Y2AL.js";
+} from "./chunk-EZ7WNPLB.js";
 import {
   ReolinkCgiApi,
   ReolinkHttpClient,

package/package.json

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