@apocaliss92/nodelink-js 0.4.14 → 0.4.16

package/dist/index.d.cts

@@ -5499,9 +5499,7 @@ declare class ReolinkBaichuanApi {
     private simpleEventSubscribed;
     private readonly detectionEventListeners;
     private readonly detectionEventStreamHooks;
-    private readonly objectDetectionListeners;
-    private objectDetectionStream;
-    private objectDetectionStreamStartInFlight;
+    private readonly objectDetectionSubs;
     private objectDetectionInternalListener;
     private simpleEventSubscribeInFlight;
     private simpleEventUnsubscribeInFlight;
@@ -5943,21 +5941,40 @@ declare class ReolinkBaichuanApi {
      * Subscribe to AI object detections (people / vehicle / animal / face boxes
      * with class label and confidence) without managing a video stream yourself.
      *
-     * Mirrors {@link onSimpleEvent} end-to-end: the API opens a dedicated
-     * substream behind the scenes on the first listener, forwards every box-bearing
-     * `additionalHeader` to your callback, and tears the stream down when the last
-     * listener unsubscribes. The substream is the lightest profile (typically
-     * 640×360) so the additional bandwidth/CPU overhead is minimal.
+     * Mirrors {@link onSimpleEvent} end-to-end: on the first listener for a given
+     * `(channel, profile)` tuple the API ensures the corresponding video stream
+     * is running (the pool socket may already be shared with a regular consumer),
+     * forwards every box-bearing `additionalHeader` to your callback, and tears
+     * the stream down when the last listener for that tuple unsubscribes.
+     *
+     * Defaults — `channel: 0`, `profile: "sub"` — match a single-lens standalone
+     * camera. **For NVR/Hub child cameras you must pass the channel explicitly**,
+     * otherwise the substream opens on channel 0 and never sees the AI boxes for
+     * the other channels. The `sub` profile is recommended (lighter bandwidth)
+     * but `main` / `ext` are accepted if you specifically need detections off a
+     * different feed.
      *
      * Each event carries normalized `[0, 1]` box coordinates, a class label, and
      * a confidence score — render-ready without further conversion.
      */
-    onObjectDetections(callback: (event: ReolinkDetectionEvent) => void | Promise<void>): Promise<void>;
+    onObjectDetections(callback: (event: ReolinkDetectionEvent) => void | Promise<void>, options?: {
+        channel?: number;
+        profile?: "main" | "sub" | "ext";
+    }): Promise<void>;
     /**
-     * Remove one detection callback, or all of them if `callback` is omitted.
-     * When the last listener is removed the auto-managed substream is closed.
+     * Remove a detection callback for a given `(channel, profile)` tuple — or,
+     * if `options` is omitted, remove the callback from every active tuple. When
+     * `callback` is also omitted, every listener on the targeted tuples is
+     * cleared. The auto-managed substream of a tuple is closed when its last
+     * listener is removed.
      */
-    offObjectDetections(callback?: (event: ReolinkDetectionEvent) => void | Promise<void>): Promise<void>;
+    offObjectDetections(callback?: (event: ReolinkDetectionEvent) => void | Promise<void>, options?: {
+        channel?: number;
+        profile?: "main" | "sub" | "ext";
+    }): Promise<void>;
+    private objectDetectionKey;
+    private ensureObjectDetectionInternalListener;
+    private maybeDropObjectDetectionInternalListener;
     private ensureObjectDetectionStream;
     private tearDownObjectDetectionStream;
     /**

package/dist/index.d.ts

@@ -6414,9 +6414,7 @@ export declare class ReolinkBaichuanApi {
     private simpleEventSubscribed;
     private readonly detectionEventListeners;
     private readonly detectionEventStreamHooks;
-    private readonly objectDetectionListeners;
-    private objectDetectionStream;
-    private objectDetectionStreamStartInFlight;
+    private readonly objectDetectionSubs;
     private objectDetectionInternalListener;
     private simpleEventSubscribeInFlight;
     private simpleEventUnsubscribeInFlight;
@@ -6858,21 +6856,40 @@ export declare class ReolinkBaichuanApi {
      * Subscribe to AI object detections (people / vehicle / animal / face boxes
      * with class label and confidence) without managing a video stream yourself.
      *
-     * Mirrors {@link onSimpleEvent} end-to-end: the API opens a dedicated
-     * substream behind the scenes on the first listener, forwards every box-bearing
-     * `additionalHeader` to your callback, and tears the stream down when the last
-     * listener unsubscribes. The substream is the lightest profile (typically
-     * 640×360) so the additional bandwidth/CPU overhead is minimal.
+     * Mirrors {@link onSimpleEvent} end-to-end: on the first listener for a given
+     * `(channel, profile)` tuple the API ensures the corresponding video stream
+     * is running (the pool socket may already be shared with a regular consumer),
+     * forwards every box-bearing `additionalHeader` to your callback, and tears
+     * the stream down when the last listener for that tuple unsubscribes.
+     *
+     * Defaults — `channel: 0`, `profile: "sub"` — match a single-lens standalone
+     * camera. **For NVR/Hub child cameras you must pass the channel explicitly**,
+     * otherwise the substream opens on channel 0 and never sees the AI boxes for
+     * the other channels. The `sub` profile is recommended (lighter bandwidth)
+     * but `main` / `ext` are accepted if you specifically need detections off a
+     * different feed.
      *
      * Each event carries normalized `[0, 1]` box coordinates, a class label, and
      * a confidence score — render-ready without further conversion.
      */
-    onObjectDetections(callback: (event: ReolinkDetectionEvent) => void | Promise<void>): Promise<void>;
+    onObjectDetections(callback: (event: ReolinkDetectionEvent) => void | Promise<void>, options?: {
+        channel?: number;
+        profile?: "main" | "sub" | "ext";
+    }): Promise<void>;
     /**
-     * Remove one detection callback, or all of them if `callback` is omitted.
-     * When the last listener is removed the auto-managed substream is closed.
+     * Remove a detection callback for a given `(channel, profile)` tuple — or,
+     * if `options` is omitted, remove the callback from every active tuple. When
+     * `callback` is also omitted, every listener on the targeted tuples is
+     * cleared. The auto-managed substream of a tuple is closed when its last
+     * listener is removed.
      */
-    offObjectDetections(callback?: (event: ReolinkDetectionEvent) => void | Promise<void>): Promise<void>;
+    offObjectDetections(callback?: (event: ReolinkDetectionEvent) => void | Promise<void>, options?: {
+        channel?: number;
+        profile?: "main" | "sub" | "ext";
+    }): Promise<void>;
+    private objectDetectionKey;
+    private ensureObjectDetectionInternalListener;
+    private maybeDropObjectDetectionInternalListener;
     private ensureObjectDetectionStream;
     private tearDownObjectDetectionStream;
     /**

package/dist/index.js

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

package/package.json

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