@apocaliss92/nodelink-js 0.4.1 → 0.4.2

package/dist/index.d.cts

@@ -1,7 +1,8 @@
 import { EventEmitter } from 'node:events';
 import { Readable } from 'node:stream';
+import * as net from 'node:net';
+import net__default from 'node:net';
 import http from 'node:http';
-import net from 'node:net';
 
 declare const BC_TCP_DEFAULT_PORT = 9000;
 /** Magic header bytes: `f0 de bc 0a` */
@@ -3346,6 +3347,12 @@ interface BaichuanRtspServerOptions {
      * isolating it from other streams on the shared socket (avoids streamType mismatch).
      */
     deviceId?: string;
+    /**
+     * When true, the server does NOT create its own net.Server.
+     * Connections are accepted externally via acceptConnection().
+     * start() still performs metadata fetch and codec detection.
+     */
+    externalListener?: boolean;
 }
 /**
  * BaichuanRtspServer - RTSP server that serves a Baichuan video stream.
@@ -3377,6 +3384,7 @@ declare class BaichuanRtspServer extends EventEmitter<{
     private flow;
     private deviceId;
     private dedicatedSessionRelease;
+    private externalListener;
     private authCredentials;
     private requireAuth;
     private authNonces;
@@ -3441,6 +3449,13 @@ declare class BaichuanRtspServer extends EventEmitter<{
      * Start the RTSP server.
      */
     start(): Promise<void>;
+    /**
+     * Accept an externally-routed RTSP connection.
+     * Used in directHandoff mode where RtspProxyServer routes sockets here.
+     * @param socket - The client TCP socket (already authenticated by proxy)
+     * @param initialBuffer - Any bytes already read during path parsing/auth
+     */
+    acceptConnection(socket: net.Socket, initialBuffer?: Buffer): void;
     /**
      * Handle RTSP connection from a client.
      */
@@ -3493,6 +3508,33 @@ declare class BaichuanRtspServer extends EventEmitter<{
      * Get number of connected clients.
      */
     getClientCount(): number;
+    /**
+     * Subscribe to the raw native stream for diagnostic purposes.
+     * The subscriber receives the same frames as RTSP clients.
+     * Counts as a "consumer" for lifecycle — prevents auto-stop while subscribed.
+     * If the native stream is not active, starts it automatically.
+     */
+    subscribeDiagnostic(id: string): Promise<AsyncGenerator<{
+        audio: boolean;
+        data: Buffer;
+        codec: string | null;
+        sampleRate: number | null;
+        microseconds: number | null;
+        videoType?: "H264" | "H265";
+    }, void, unknown>>;
+    /**
+     * Unsubscribe a diagnostic session.
+     */
+    unsubscribeDiagnostic(id: string): void;
+    /**
+     * Returns detected audio metadata (available after first audio frame).
+     */
+    getAudioInfo(): {
+        codec: "aac-adts";
+        sampleRate: number;
+        channels: number;
+        configHex: string;
+    } | null;
 }
 
 /**
@@ -7610,7 +7652,7 @@ declare function packetizeAacRawFrame(raw: Buffer, rtp: RtpWriter): {
     packets: Buffer[];
 };
 interface Rfc4571Client {
-    socket: net.Socket;
+    socket: net__default.Socket;
     needsKeyframe: boolean;
     sentVideoConfig: boolean;
 }
@@ -7637,7 +7679,7 @@ declare class Rfc4571Muxer {
     private cachedH264ParamSetsAnnexB;
     private cachedH265ParamSetsAnnexB;
     constructor(logger: Console, videoPayloadType: number, audioPayloadType: number | undefined, videoFpsFallback?: number, maxRtpPayload?: number);
-    addClient(socket: net.Socket): void;
+    addClient(socket: net__default.Socket): void;
     private static readonly ANNEXB_START_CODE;
     private static joinAnnexBNals;
     private updateVideoParamSetsFromAccessUnit;
@@ -7759,7 +7801,7 @@ interface Rfc4571TcpServer {
     };
     username: string;
     password: string;
-    server: net.Server;
+    server: net__default.Server;
     videoStream: BaichuanVideoStream | CompositeStream;
     close: (reason?: unknown) => Promise<void>;
 }
@@ -7815,7 +7857,7 @@ interface Rfc4571ReplayServer {
     };
     username: string;
     password: string;
-    server: net.Server;
+    server: net__default.Server;
     videoStream: BaichuanVideoStream;
     /** Called when replay naturally ends (all data sent). */
     onReplayEnd?: () => void;

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import { EventEmitter } from 'node:events';
 import http from 'node:http';
-import net from 'node:net';
+import * as net from 'node:net';
+import { default as net_2 } from 'node:net';
 import { Readable } from 'node:stream';
 
 export declare function abilitiesHasAny(abilities: AbilityInfo | undefined, re: RegExp): boolean;
@@ -1291,6 +1292,7 @@ export declare class BaichuanRtspServer extends EventEmitter<{
     private flow;
     private deviceId;
     private dedicatedSessionRelease;
+    private externalListener;
     private authCredentials;
     private requireAuth;
     private authNonces;
@@ -1355,6 +1357,13 @@ export declare class BaichuanRtspServer extends EventEmitter<{
      * Start the RTSP server.
      */
     start(): Promise<void>;
+    /**
+     * Accept an externally-routed RTSP connection.
+     * Used in directHandoff mode where RtspProxyServer routes sockets here.
+     * @param socket - The client TCP socket (already authenticated by proxy)
+     * @param initialBuffer - Any bytes already read during path parsing/auth
+     */
+    acceptConnection(socket: net.Socket, initialBuffer?: Buffer): void;
     /**
      * Handle RTSP connection from a client.
      */
@@ -1407,6 +1416,33 @@ export declare class BaichuanRtspServer extends EventEmitter<{
      * Get number of connected clients.
      */
     getClientCount(): number;
+    /**
+     * Subscribe to the raw native stream for diagnostic purposes.
+     * The subscriber receives the same frames as RTSP clients.
+     * Counts as a "consumer" for lifecycle — prevents auto-stop while subscribed.
+     * If the native stream is not active, starts it automatically.
+     */
+    subscribeDiagnostic(id: string): Promise<AsyncGenerator<{
+        audio: boolean;
+        data: Buffer;
+        codec: string | null;
+        sampleRate: number | null;
+        microseconds: number | null;
+        videoType?: "H264" | "H265";
+    }, void, unknown>>;
+    /**
+     * Unsubscribe a diagnostic session.
+     */
+    unsubscribeDiagnostic(id: string): void;
+    /**
+     * Returns detected audio metadata (available after first audio frame).
+     */
+    getAudioInfo(): {
+        codec: "aac-adts";
+        sampleRate: number;
+        channels: number;
+        configHex: string;
+    } | null;
 }
 
 export declare interface BaichuanRtspServerOptions {
@@ -1441,6 +1477,12 @@ export declare interface BaichuanRtspServerOptions {
      * isolating it from other streams on the shared socket (avoids streamType mismatch).
      */
     deviceId?: string;
+    /**
+     * When true, the server does NOT create its own net.Server.
+     * Connections are accepted externally via acceptConnection().
+     * start() still performs metadata fetch and codec detection.
+     */
+    externalListener?: boolean;
 }
 
 export declare type BaichuanSerialPush = {
@@ -8409,7 +8451,7 @@ export declare interface Rfc4571ApiFactoryContext {
 }
 
 export declare interface Rfc4571Client {
-    socket: net.Socket;
+    socket: net_2.Socket;
     needsKeyframe: boolean;
     sentVideoConfig: boolean;
 }
@@ -8437,7 +8479,7 @@ export declare class Rfc4571Muxer {
     private cachedH264ParamSetsAnnexB;
     private cachedH265ParamSetsAnnexB;
     constructor(logger: Console, videoPayloadType: number, audioPayloadType: number | undefined, videoFpsFallback?: number, maxRtpPayload?: number);
-    addClient(socket: net.Socket): void;
+    addClient(socket: net_2.Socket): void;
     private static readonly ANNEXB_START_CODE;
     private static joinAnnexBNals;
     private updateVideoParamSetsFromAccessUnit;
@@ -8477,7 +8519,7 @@ export declare interface Rfc4571ReplayServer {
     };
     username: string;
     password: string;
-    server: net.Server;
+    server: net_2.Server;
     videoStream: BaichuanVideoStream;
     /** Called when replay naturally ends (all data sent). */
     onReplayEnd?: () => void;
@@ -8536,7 +8578,7 @@ export declare interface Rfc4571TcpServer {
     };
     username: string;
     password: string;
-    server: net.Server;
+    server: net_2.Server;
     videoStream: BaichuanVideoStream | CompositeStream;
     close: (reason?: unknown) => Promise<void>;
 }

package/dist/index.js

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

package/package.json

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