@apocaliss92/nodelink-js 0.4.19 → 0.4.20

package/dist/index.d.cts

@@ -5474,6 +5474,19 @@ declare class ReolinkBaichuanApi {
     private _isMultiFocal;
     /** Maximum dedicated sessions allowed before triggering a reboot (default: 7). */
     private maxDedicatedSessionsBeforeReboot;
+    /**
+     * Opt-in: when `false` (default), the lib never starts the 60s periodic
+     * `getOnlineUserList` poll and never schedules an automatic reboot based
+     * on the session count. The post-socket-create probe at line ~1859 is
+     * also skipped. Consumers that want the legacy behaviour can pass
+     * `enableSessionGuard: true` to the constructor.
+     *
+     * Rationale: on BCUDP (battery cameras) the periodic poll wakes the
+     * camera every minute and triggers a perpetual sleeping↔awake cycle —
+     * see issue #18. Even on AC cameras the auto-reboot side effect is
+     * surprising; making it explicit avoids astonishment.
+     */
+    private sessionGuardEnabled;
     private sessionGuardRebootInFlight;
     private sessionGuardLastRebootAtMs;
     /** Track last known session count and IDs for change detection. */
@@ -5829,6 +5842,18 @@ declare class ReolinkBaichuanApi {
         rebootAfterConsecutiveEconnreset?: number;
         /** If true, avoid using HTTP/CGI fallbacks and discovery paths (native Baichuan only). */
         nativeOnly?: boolean;
+        /**
+         * Enable the periodic session-count guard: every 60s the lib polls
+         * `getOnlineUserList` (cmd_id 120) and triggers a device reboot if
+         * sessions from our IP exceed `maxDedicatedSessionsBeforeReboot`.
+         *
+         * Default: `false`. The poll wakes battery cameras on every tick and
+         * its only side effect — an automatic reboot — is a heavy-hand fix
+         * for a problem that rarely materialises in practice. Set to `true`
+         * only if you specifically need the legacy auto-recovery behaviour;
+         * even then the lib skips the poll on UDP transport.
+         */
+        enableSessionGuard?: boolean;
     });
     /**
      * CGI forward: fetch RTSP URL for a channel via `GetRtspUrl`.

package/dist/index.d.ts

@@ -6389,6 +6389,19 @@ export declare class ReolinkBaichuanApi {
     private _isMultiFocal;
     /** Maximum dedicated sessions allowed before triggering a reboot (default: 7). */
     private maxDedicatedSessionsBeforeReboot;
+    /**
+     * Opt-in: when `false` (default), the lib never starts the 60s periodic
+     * `getOnlineUserList` poll and never schedules an automatic reboot based
+     * on the session count. The post-socket-create probe at line ~1859 is
+     * also skipped. Consumers that want the legacy behaviour can pass
+     * `enableSessionGuard: true` to the constructor.
+     *
+     * Rationale: on BCUDP (battery cameras) the periodic poll wakes the
+     * camera every minute and triggers a perpetual sleeping↔awake cycle —
+     * see issue #18. Even on AC cameras the auto-reboot side effect is
+     * surprising; making it explicit avoids astonishment.
+     */
+    private sessionGuardEnabled;
     private sessionGuardRebootInFlight;
     private sessionGuardLastRebootAtMs;
     /** Track last known session count and IDs for change detection. */
@@ -6744,6 +6757,18 @@ export declare class ReolinkBaichuanApi {
         rebootAfterConsecutiveEconnreset?: number;
         /** If true, avoid using HTTP/CGI fallbacks and discovery paths (native Baichuan only). */
         nativeOnly?: boolean;
+        /**
+         * Enable the periodic session-count guard: every 60s the lib polls
+         * `getOnlineUserList` (cmd_id 120) and triggers a device reboot if
+         * sessions from our IP exceed `maxDedicatedSessionsBeforeReboot`.
+         *
+         * Default: `false`. The poll wakes battery cameras on every tick and
+         * its only side effect — an automatic reboot — is a heavy-hand fix
+         * for a problem that rarely materialises in practice. Set to `true`
+         * only if you specifically need the legacy auto-recovery behaviour;
+         * even then the lib skips the poll on UDP transport.
+         */
+        enableSessionGuard?: 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-5M7BGMLV.js";
+} from "./chunk-XUL2Y2AL.js";
 import {
   ReolinkCgiApi,
   ReolinkHttpClient,

package/package.json

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