@apocaliss92/nodelink-js 0.4.4 → 0.4.5

package/dist/index.d.cts

@@ -1009,11 +1009,13 @@ interface ReolinkDayNightNotification {
     timestamp?: number;
 }
 type ReolinkEvent = ReolinkMotionNotification | ReolinkAiNotification | ReolinkVisitorNotification | ReolinkDayNightNotification;
-type ReolinkSimpleEventType = "motion" | "doorbell" | "people" | "vehicle" | "animal" | "face" | "package" | "daynight" | "sleeping" | "awake" | "online" | "offline" | "other";
+type ReolinkSimpleEventType = "motion" | "doorbell" | "people" | "vehicle" | "animal" | "face" | "package" | "daynight" | "sleeping" | "awake" | "online" | "offline" | "battery" | "other";
 interface ReolinkSimpleEvent {
     type: ReolinkSimpleEventType;
     channel: number;
     timestamp: number;
+    /** Present when type === "battery" — pushed by the camera via cmdId 252. */
+    battery?: Partial<BatteryInfo>;
 }
 interface TwoWayAudioConfig {
     channel: number;
@@ -1935,6 +1937,11 @@ declare class BaichuanClient extends EventEmitter<{
     debug: [string, unknown?];
     event: [ReolinkEvent];
     channelInfo: [string];
+    batteryPush: [BaichuanFrame];
+    d2c_disc: [{
+        host: string;
+        atMs: number;
+    }];
 }> {
     /**
      * Process-wide streaming activity registry.
@@ -1946,6 +1953,14 @@ declare class BaichuanClient extends EventEmitter<{
      *   even if the current client instance is idle/disconnected.
      */
     private static readonly streamingRegistry;
+    /**
+     * Per-host D2C_DISC backoff state that persists across client instance recreation.
+     *
+     * Why: when a D2C_DISC kills a client, the socket pool destroys the old instance
+     * and creates a new one. Instance-level backoff variables would reset to zero,
+     * allowing immediate reconnection and perpetuating the storm.
+     */
+    private static readonly d2cDiscBackoff;
     /**
      * Global (process-wide) CoverPreview serialization.
      *
@@ -4338,6 +4353,19 @@ declare class ReolinkBaichuanApi {
     private readonly aiAlarmCandidateTypesCache;
     private rtspServers;
     private readonly activeVideoMsgNums;
+    /** Timestamp of the most recent D2C_DISC from any client for this device. */
+    private lastD2cDiscAtMs;
+    /** Sliding window of recent D2C_DISC timestamps for storm detection. */
+    private readonly d2cDiscTimestamps;
+    /** Immediate cooldown (ms) applied to socket pool on every D2C_DISC.
+     *  Prevents reconnect attempts while the camera is transitioning to sleep. */
+    private static readonly D2C_DISC_IMMEDIATE_COOLDOWN_MS;
+    /** Number of D2C_DISCs within the storm window to trigger extended cooldown. */
+    private static readonly D2C_DISC_STORM_THRESHOLD;
+    /** Sliding window size (ms) for storm detection. */
+    private static readonly D2C_DISC_STORM_WINDOW_MS;
+    /** Extended cooldown (ms) applied to socket pool when a D2C_DISC storm is detected. */
+    private static readonly D2C_DISC_STORM_COOLDOWN_MS;
     private readonly nvrChannelsSummaryCache;
     /**
      * Cached device capabilities per channel.
@@ -4512,6 +4540,12 @@ declare class ReolinkBaichuanApi {
      * @returns The socket pool tag to use
      */
     private resolveSocketTag;
+    /**
+     * Attach a D2C_DISC listener to a BaichuanClient so that the API-level
+     * grace period and storm detection are updated regardless of which
+     * pool socket receives the disconnect.
+     */
+    private attachD2cDiscListener;
     /**
      * Acquire a socket from the pool by tag.
      * Creates a new socket if needed, or reuses an existing one.
@@ -5657,6 +5691,15 @@ declare class ReolinkBaichuanApi {
     zoomToFactor(zoomFactor: number, channel?: number): Promise<void>;
     zoomToFactor(channel: number, zoomFactor: number): Promise<void>;
     private parseBatteryInfoXml;
+    /**
+     * Called when any BaichuanClient for this device receives a D2C_DISC.
+     *
+     * Two-tier response:
+     *  1. **Immediate**: every D2C_DISC applies a short socket pool cooldown
+     *     (10 s) to prevent reconnect attempts while the camera transitions to sleep.
+     *  2. **Storm**: ≥3 D2C_DISCs within 60 s triggers extended cooldown (120 s).
+     */
+    private notifyD2cDisc;
     /**
      * Best-effort sleeping inference for battery/BCUDP cameras.
      *

package/dist/index.d.ts

@@ -396,6 +396,11 @@ export declare class BaichuanClient extends EventEmitter<{
     debug: [string, unknown?];
     event: [ReolinkEvent];
     channelInfo: [string];
+    batteryPush: [BaichuanFrame];
+    d2c_disc: [{
+        host: string;
+        atMs: number;
+    }];
 }> {
     /**
      * Process-wide streaming activity registry.
@@ -407,6 +412,14 @@ export declare class BaichuanClient extends EventEmitter<{
      *   even if the current client instance is idle/disconnected.
      */
     private static readonly streamingRegistry;
+    /**
+     * Per-host D2C_DISC backoff state that persists across client instance recreation.
+     *
+     * Why: when a D2C_DISC kills a client, the socket pool destroys the old instance
+     * and creates a new one. Instance-level backoff variables would reset to zero,
+     * allowing immediate reconnection and perpetuating the storm.
+     */
+    private static readonly d2cDiscBackoff;
     /**
      * Global (process-wide) CoverPreview serialization.
      *
@@ -5183,6 +5196,19 @@ export declare class ReolinkBaichuanApi {
     private readonly aiAlarmCandidateTypesCache;
     private rtspServers;
     private readonly activeVideoMsgNums;
+    /** Timestamp of the most recent D2C_DISC from any client for this device. */
+    private lastD2cDiscAtMs;
+    /** Sliding window of recent D2C_DISC timestamps for storm detection. */
+    private readonly d2cDiscTimestamps;
+    /** Immediate cooldown (ms) applied to socket pool on every D2C_DISC.
+     *  Prevents reconnect attempts while the camera is transitioning to sleep. */
+    private static readonly D2C_DISC_IMMEDIATE_COOLDOWN_MS;
+    /** Number of D2C_DISCs within the storm window to trigger extended cooldown. */
+    private static readonly D2C_DISC_STORM_THRESHOLD;
+    /** Sliding window size (ms) for storm detection. */
+    private static readonly D2C_DISC_STORM_WINDOW_MS;
+    /** Extended cooldown (ms) applied to socket pool when a D2C_DISC storm is detected. */
+    private static readonly D2C_DISC_STORM_COOLDOWN_MS;
     private readonly nvrChannelsSummaryCache;
     /**
      * Cached device capabilities per channel.
@@ -5357,6 +5383,12 @@ export declare class ReolinkBaichuanApi {
      * @returns The socket pool tag to use
      */
     private resolveSocketTag;
+    /**
+     * Attach a D2C_DISC listener to a BaichuanClient so that the API-level
+     * grace period and storm detection are updated regardless of which
+     * pool socket receives the disconnect.
+     */
+    private attachD2cDiscListener;
     /**
      * Acquire a socket from the pool by tag.
      * Creates a new socket if needed, or reuses an existing one.
@@ -6502,6 +6534,15 @@ export declare class ReolinkBaichuanApi {
     zoomToFactor(zoomFactor: number, channel?: number): Promise<void>;
     zoomToFactor(channel: number, zoomFactor: number): Promise<void>;
     private parseBatteryInfoXml;
+    /**
+     * Called when any BaichuanClient for this device receives a D2C_DISC.
+     *
+     * Two-tier response:
+     *  1. **Immediate**: every D2C_DISC applies a short socket pool cooldown
+     *     (10 s) to prevent reconnect attempts while the camera transitions to sleep.
+     *  2. **Storm**: ≥3 D2C_DISCs within 60 s triggers extended cooldown (120 s).
+     */
+    private notifyD2cDisc;
     /**
      * Best-effort sleeping inference for battery/BCUDP cameras.
      *
@@ -8361,9 +8402,11 @@ export declare interface ReolinkSimpleEvent {
     type: ReolinkSimpleEventType;
     channel: number;
     timestamp: number;
+    /** Present when type === "battery" — pushed by the camera via cmdId 252. */
+    battery?: Partial<BatteryInfo>;
 }
 
-export declare type ReolinkSimpleEventType = "motion" | "doorbell" | "people" | "vehicle" | "animal" | "face" | "package" | "daynight" | "sleeping" | "awake" | "online" | "offline" | "other";
+export declare type ReolinkSimpleEventType = "motion" | "doorbell" | "people" | "vehicle" | "animal" | "face" | "package" | "daynight" | "sleeping" | "awake" | "online" | "offline" | "battery" | "other";
 
 /**
  * Complete media stream options with all available metadata.

package/dist/index.js

@@ -43,7 +43,7 @@ import {
   parseSupportXml,
   setGlobalLogger,
   xmlIndicatesFloodlight
-} from "./chunk-UHFJPQA4.js";
+} from "./chunk-WDFKIHM5.js";
 import {
   AesStreamDecryptor,
   BC_AES_IV,