@apocaliss92/nodelink-js 0.3.4 → 0.3.9

package/dist/index.d.cts

@@ -1961,6 +1961,22 @@ declare class BaichuanClient extends EventEmitter<{
     private static readonly coverPreviewBackoffMs;
     private static readonly COVER_PREVIEW_INITIAL_BACKOFF_MS;
     private static readonly COVER_PREVIEW_MAX_BACKOFF_MS;
+    /**
+     * Per-client snapshot (cmd_id=109) serialization queue.
+     *
+     * WHY: On NVR/multi-camera devices sharing one socket, concurrent snapshot requests
+     * can cause JPEG data to mix (even with per-request msgNum filtering):
+     * - Camera A and B both send frames on same socket
+     * - Frame listener is global per socket
+     * - Timing quirks can cause chunk reordering or listener confusion
+     *
+     * FIX: Serialize all cmd_id=109 requests on THIS client instance.
+     * Each snapshot waits for previous one to complete before starting.
+     * This ensures clean frame sequences per request, zero data corruption.
+     *
+     * Impact: Snapshots are ~0–50ms slower per camera (negligible for users).
+     */
+    private snapshotQueueTail;
     private readonly opts;
     private readonly debugCfg;
     private readonly logger;
@@ -2307,6 +2323,7 @@ declare class BaichuanClient extends EventEmitter<{
     private sendBinaryFileDownload6482;
     private sendBinaryFileInfoListReplay5;
     private sendBinarySnapshot109;
+    private sendBinarySnapshot109Impl;
     /**
      * Send CoverPreview command (cmd_id=298) to get an I-frame from a past recording.
      * Similar to sendBinarySnapshot109 but handles the stream header + frame format
@@ -3849,6 +3866,42 @@ declare function runAllDiagnosticsConsecutively(params: RunAllDiagnosticsConsecu
     diagnosticsPath: string;
     streamsDir: string;
 }>;
+interface ModelFixtureCaptureResult {
+    /** Per-call results: command name → ok/error */
+    calls: Record<string, {
+        ok: true;
+        value?: unknown;
+    } | {
+        ok: false;
+        error: string;
+    }>;
+    /** Output directory where fixtures were written */
+    outDir: string;
+    /** Summary counters */
+    summary: {
+        total: number;
+        ok: number;
+        failed: number;
+        errors: string[];
+    };
+}
+/**
+ * Capture all relevant API responses from a single device (or NVR channel)
+ * and write them as JSON/XML fixtures into `outDir`.
+ *
+ * This is the library-level building block used by both:
+ *   - `test/capture-model-fixtures.ts` (CLI)
+ *   - the Scrypted plugin's "Dump Model Fixtures" setting action
+ *
+ * For NVR/Hub devices, call once per active channel.
+ */
+declare function captureModelFixtures(params: {
+    api: ReolinkBaichuanApi;
+    channel: number;
+    outDir: string;
+    /** Logger (defaults to console) */
+    log?: (...args: unknown[]) => void;
+}): Promise<ModelFixtureCaptureResult>;
 
 /**
  * Multifocal Camera Composite Stream
@@ -7241,6 +7294,17 @@ declare function computeDeviceCapabilities(params: {
     abilities?: DeviceAbilities;
     support?: SupportInfo;
 }): DeviceCapabilities;
+/**
+ * Determine whether a cmd 289 (GetWhiteLed) XML response indicates
+ * controllable floodlight/spotlight hardware.
+ *
+ * `<FloodlightTask>`, `<FloodlightManual>`, and `<FloodlightStatusList>` are
+ * conclusive.  `<WhiteLed>` is ambiguous — doorbells (e.g. D340W) return it
+ * for their status-indicator LED which is NOT a floodlight.  Only treat
+ * `<WhiteLed>` as floodlight when brightness or scheduling controls are
+ * present (`brightness_cur`, `bright`, `LightingSchedule`).
+ */
+declare function xmlIndicatesFloodlight(xml: string): boolean;
 
 type RtspStreamProfile = "main" | "sub" | "ext";
 declare function buildRtspPath(channel: number, stream: RtspStreamProfile): string;
@@ -7784,6 +7848,125 @@ interface ReplayHttpServer {
  */
 declare function createReplayHttpServer(options: ReplayHttpServerOptions): Promise<ReplayHttpServer>;
 
+/**
+ * Go2rtcTcpServer — Lightweight TCP server that feeds raw Annex-B video
+ * (H.264 / H.265) and ADTS AAC audio frames to go2rtc via a plain TCP
+ * connection.
+ *
+ * go2rtc configuration example:
+ *   streams:
+ *     camera_main: tcp://127.0.0.1:{port}
+ *
+ * go2rtc auto-detects the codec from the bitstream (SPS/PPS/VPS NALUs).
+ *
+ * Lifecycle:
+ *   1. Server starts listening immediately on the configured port.
+ *   2. When the first TCP client connects the native camera stream is started.
+ *   3. Frames are fan-out to every connected client (go2rtc typically opens
+ *      one connection, but multiple are supported).
+ *   4. When the last client disconnects a grace period runs before stopping
+ *      the native stream (avoids thrashing on rapid reconnects).
+ *   5. A prebuffer ring keeps the last few seconds of frames so new clients
+ *      get IDR-aligned fast startup without waiting for the next keyframe.
+ */
+
+interface Go2rtcTcpServerOptions {
+    /** API instance (required). */
+    api: ReolinkBaichuanApi;
+    /** Channel number (required). */
+    channel: number;
+    /** Stream profile (required). */
+    profile: StreamProfile;
+    /** TrackMix tele/autotrack variant. */
+    variant?: NativeVideoStreamVariant;
+    /** Host to listen on (default: "127.0.0.1"). */
+    listenHost?: string;
+    /** Port to listen on (default: 0 = OS picks). */
+    listenPort?: number;
+    /** Logger. */
+    logger?: Logger;
+    /**
+     * External identifier for dedicated socket session.
+     * When provided, a dedicated BaichuanClient is created for the stream,
+     * isolating it from other streams on the shared socket.
+     */
+    deviceId?: string;
+    /** Grace period in ms before stopping native stream after last client disconnects (default: 30 000). */
+    gracePeriodMs?: number;
+    /** Maximum prebuffer window in ms (default: 3 000). */
+    prebufferMs?: number;
+    /** Maximum write buffer per client before dropping the connection (default: 100 MB). */
+    maxBufferBytes?: number;
+    /**
+     * When true, the native camera stream is started immediately on start()
+     * rather than waiting for the first TCP client. This ensures frames are
+     * already flowing (and the prebuffer is warm) when go2rtc connects.
+     * Default: true.
+     */
+    prestartStream?: boolean;
+}
+declare class Go2rtcTcpServer extends EventEmitter<{
+    client: [string];
+    clientDisconnected: [string];
+    error: [Error];
+    close: [];
+    listening: [{
+        host: string;
+        port: number;
+    }];
+}> {
+    private readonly api;
+    private readonly channel;
+    private readonly profile;
+    private readonly variant;
+    private readonly listenHost;
+    private readonly listenPort;
+    private readonly logger;
+    private readonly deviceId;
+    private readonly gracePeriodMs;
+    private readonly prebufferMaxMs;
+    private readonly maxBufferBytes;
+    private readonly prestartStream;
+    private active;
+    private server;
+    private resolvedPort;
+    private nativeFanout;
+    private nativeStreamActive;
+    private dedicatedSessionRelease;
+    private detectedVideoType;
+    private connectedClients;
+    private clientSockets;
+    private stopGraceTimer;
+    private prebuffer;
+    constructor(options: Go2rtcTcpServerOptions);
+    /** Start listening. Resolves once the TCP server is bound. */
+    start(): Promise<void>;
+    /** Stop the server and all active streams. */
+    stop(): Promise<void>;
+    /** The actual port the server is listening on (available after start()). */
+    get port(): number | undefined;
+    /** The go2rtc-compatible source URL. */
+    get go2rtcSourceUrl(): string | undefined;
+    /** Number of currently connected clients. */
+    get clientCount(): number;
+    private handleClient;
+    private feedClient;
+    /**
+     * Convert a native frame to wire-ready Annex-B.
+     * Audio frames are skipped — raw TCP carries only video (Annex-B).
+     * go2rtc auto-detects the codec from SPS/PPS/VPS NALUs.
+     */
+    private convertFrame;
+    /** Check if an Annex-B buffer contains a keyframe (IDR for H.264, IRAP for H.265). */
+    private isAnnexBKeyframe;
+    /** Split Annex-B byte stream into individual NAL units. */
+    private static splitAnnexBNals;
+    private startNativeStream;
+    private stopNativeStream;
+    private removeClient;
+    private scheduleStop;
+}
+
 /**
  * Baichuan HTTP Stream Server - Serves a Baichuan video stream over HTTP (MPEG-TS).
  * A simpler alternative to an RTSP server.
@@ -8756,4 +8939,4 @@ declare class CompositeRtspServer extends EventEmitter<{
     getClientCount(): number;
 }
 
-export { type AIDetectionState, type AIEvent, type AIState, type AbilityInfo, type AccessUserListConfig, AesStreamDecryptor, type AiAlarmConfig, type AiConfig, type AiDenoiseConfig, type AiKey, type AiTypesCacheEntry, type AnyBuffer, type AudioAlarmParams, type AudioCfgConfig, type AudioConfig, type AudioTaskConfig, type AutoDetectInputs, type AutoDetectMode, type AutoDetectResult, AutodiscoveryClient, type AutodiscoveryClientOptions, BC_AES_IV, BC_CLASS_FILE_DOWNLOAD, BC_CLASS_LEGACY, BC_CLASS_MODERN_20, BC_CLASS_MODERN_24, BC_CLASS_MODERN_24_ALT, BC_CMD_ID_ABILITY_INFO, BC_CMD_ID_ALARM_EVENT_LIST, BC_CMD_ID_AUDIO_ALARM_PLAY, BC_CMD_ID_CHANNEL_INFO_ALL, BC_CMD_ID_CMD_123, BC_CMD_ID_CMD_209, BC_CMD_ID_CMD_265, BC_CMD_ID_CMD_440, BC_CMD_ID_COVER_PREVIEW, BC_CMD_ID_COVER_RESPONSE, BC_CMD_ID_COVER_STANDALONE_458, BC_CMD_ID_COVER_STANDALONE_459, BC_CMD_ID_COVER_STANDALONE_460, BC_CMD_ID_COVER_STANDALONE_461, BC_CMD_ID_COVER_STANDALONE_462, BC_CMD_ID_DING_DONG_CTRL, BC_CMD_ID_DING_DONG_OPT, BC_CMD_ID_FILE_INFO_LIST_CLOSE, BC_CMD_ID_FILE_INFO_LIST_DL_VIDEO, BC_CMD_ID_FILE_INFO_LIST_DOWNLOAD, BC_CMD_ID_FILE_INFO_LIST_GET, BC_CMD_ID_FILE_INFO_LIST_OPEN, BC_CMD_ID_FILE_INFO_LIST_REPLAY, BC_CMD_ID_FILE_INFO_LIST_STOP, BC_CMD_ID_FIND_REC_VIDEO_CLOSE, BC_CMD_ID_FIND_REC_VIDEO_GET, BC_CMD_ID_FIND_REC_VIDEO_OPEN, BC_CMD_ID_FLOODLIGHT_STATUS_LIST, BC_CMD_ID_GET_ABILITY_SUPPORT, BC_CMD_ID_GET_ACCESS_USER_LIST, BC_CMD_ID_GET_AI_ALARM, BC_CMD_ID_GET_AI_CFG, BC_CMD_ID_GET_AI_DENOISE, BC_CMD_ID_GET_AUDIO_ALARM, BC_CMD_ID_GET_AUDIO_CFG, BC_CMD_ID_GET_AUDIO_TASK, BC_CMD_ID_GET_BATTERY_INFO, BC_CMD_ID_GET_BATTERY_INFO_LIST, BC_CMD_ID_GET_DAY_NIGHT_THRESHOLD, BC_CMD_ID_GET_DAY_RECORDS, BC_CMD_ID_GET_DING_DONG_CFG, BC_CMD_ID_GET_DING_DONG_LIST, BC_CMD_ID_GET_DING_DONG_SILENT, BC_CMD_ID_GET_EMAIL_TASK, BC_CMD_ID_GET_FTP_TASK, BC_CMD_ID_GET_HDD_INFO_LIST, BC_CMD_ID_GET_KIT_AP_CFG, BC_CMD_ID_GET_LED_STATE, BC_CMD_ID_GET_MOTION_ALARM, BC_CMD_ID_GET_ONLINE_USER_LIST, BC_CMD_ID_GET_OSD_DATETIME, BC_CMD_ID_GET_PIR_INFO, BC_CMD_ID_GET_PTZ_POSITION, BC_CMD_ID_GET_PTZ_PRESET, BC_CMD_ID_GET_RECORD, BC_CMD_ID_GET_RECORD_CFG, BC_CMD_ID_GET_REC_ENC_CFG, BC_CMD_ID_GET_SIREN_STATUS, BC_CMD_ID_GET_SLEEP_STATE, BC_CMD_ID_GET_STREAM_INFO_LIST, BC_CMD_ID_GET_SUPPORT, BC_CMD_ID_GET_SYSTEM_GENERAL, BC_CMD_ID_GET_TIMELAPSE_CFG, BC_CMD_ID_GET_VIDEO_INPUT, BC_CMD_ID_GET_WHITE_LED, BC_CMD_ID_GET_WIFI, BC_CMD_ID_GET_WIFI_SIGNAL, BC_CMD_ID_GET_ZOOM_FOCUS, BC_CMD_ID_LOGIN, BC_CMD_ID_LOGOUT, BC_CMD_ID_PING, BC_CMD_ID_PTZ_CONTROL, BC_CMD_ID_PTZ_CONTROL_PRESET, BC_CMD_ID_PUSH_COORDINATE_POINT_LIST, BC_CMD_ID_PUSH_DINGDONG_LIST, BC_CMD_ID_PUSH_NET_INFO, BC_CMD_ID_PUSH_SERIAL, BC_CMD_ID_PUSH_SLEEP_STATUS, BC_CMD_ID_PUSH_VIDEO_INPUT, BC_CMD_ID_QUICK_REPLY_PLAY, BC_CMD_ID_SET_AI_ALARM, BC_CMD_ID_SET_AI_CFG, BC_CMD_ID_SET_AUDIO_TASK, BC_CMD_ID_SET_DING_DONG_CFG, BC_CMD_ID_SET_DING_DONG_SILENT, BC_CMD_ID_SET_MOTION_ALARM, BC_CMD_ID_SET_PIR_INFO, BC_CMD_ID_SET_WHITE_LED_STATE, BC_CMD_ID_SET_WHITE_LED_TASK, BC_CMD_ID_SET_ZOOM_FOCUS, BC_CMD_ID_SUPPORT, BC_CMD_ID_TALK, BC_CMD_ID_TALK_ABILITY, BC_CMD_ID_TALK_CONFIG, BC_CMD_ID_TALK_RESET, BC_CMD_ID_UDP_KEEP_ALIVE, BC_CMD_ID_VIDEO, BC_CMD_ID_VIDEO_STOP, BC_MAGIC, BC_MAGIC_REV, BC_TCP_DEFAULT_PORT, BC_XML_KEY, type BaichuanCachedPush, BaichuanClient, type BaichuanClientOptions, type BaichuanCoordinatePointListPush, type BaichuanDingdongListPush, type BaichuanEndpointsServerOptions, BaichuanEventEmitter, type BaichuanFrame, BaichuanFrameParser, type BaichuanGetOsdDatetimeResult, type BaichuanHeader, BaichuanHlsServer, type BaichuanHlsServerOptions, BaichuanHttpStreamServer, type BaichuanHttpStreamServerOptions, type BaichuanLedState, BaichuanMjpegServer, type BaichuanMjpegServerOptions, type BaichuanNetInfoPush, type BaichuanOsdChannelName, type BaichuanOsdDatetime, type BaichuanRecordCfg, type BaichuanRecordSchedule, BaichuanRtspServer, type BaichuanRtspServerOptions, type BaichuanSerialPush, type BaichuanSettingsPushCacheEntry, type BaichuanSleepState, type BaichuanSleepStatusPush, type BaichuanStreamEncodeTable, type BaichuanStreamInfo, type BaichuanStreamInfoList, type BaichuanTransport, type BaichuanVideoInputPush, BaichuanVideoStream, type BaichuanVideoStreamOptions, BaichuanWebRTCServer, type BaichuanWebRTCServerOptions, type BaichuanWifi, type BaichuanWifiSignal, type BatteryInfo, type BatteryInfoResponse, type BcMedia, type BcMediaAac, type BcMediaAdpcm, BcMediaAnnexBDecoder, type BcMediaAnnexBDecoderStats, type BcMediaAnnexBInfo, type BcMediaAudioFrame, type BcMediaAudioType, BcMediaCodec, type BcMediaIframe, type BcMediaInfoV1, type BcMediaInfoV2, type BcMediaPframe, type BcMediaType, type BcMediaVideoFrame, type BcMediaVideoType, type BcUdpDiscoveryMethod, BcUdpStream, type BcUdpStreamOptions, type CgiAbility, type CgiAbilityChn, type CgiAbilityLeaf, type CgiAiKey, type CgiAiStateValue, type CgiAudioAlarmPlayParam, type CgiBattery, type CgiChannelStatusEntry, type CgiChnTypeInfoValue, type CgiDetectionState, type CgiDevInfo, type CgiDeviceInfoEntries, type CgiEnc, type CgiEncStream, type CgiEncValue, type CgiGetAbilityResponse, type CgiGetAbilityValue, type CgiGetAiStateResponse, type CgiGetChannelstatusResponse, type CgiGetChannelstatusValue, type CgiGetChnTypeInfoResponse, type CgiGetDevInfoResponse, type CgiGetDevInfoValue, type CgiGetEncResponse, type CgiGetOsdValue, type CgiGetRtspUrlResponse, type CgiGetRtspUrlValue, type CgiGetVideoclipsParams, type CgiNetPort, type CgiOsd, type CgiPirInfo, type CgiPtzPreset, type CgiSetOsdParam, type CgiSetPirInfoParam, type CgiSetWhiteLedParam, type CgiWhiteLed, type ChannelPushCacheEntry, type ChannelPushDataEntry, type ChannelRecordingFile, type ChannelStreamMetadata, type ChimeAlarmCfg, type ChimeCfg, type ChimeDevice, type ChimeParams, type CollectNvrDiagnosticsOptions, CompositeRtspServer, type CompositeRtspServerOptions, CompositeStream, type CompositeStreamOptions, type CompositeStreamPipOptions, DUAL_LENS_DUAL_MOTION_MODELS, DUAL_LENS_MODELS, DUAL_LENS_SINGLE_MOTION_MODELS, type DayNightThresholdConfig, type DebugConfig, type DebugOptions, type DeviceAbilities, type DeviceCapabilities, type DeviceCapabilitiesCacheEntry, type DeviceCapabilitiesDebugInfo, type DeviceCapabilitiesResult, type DeviceInfoResponse, type DeviceInputData, type DeviceObjectType, type DeviceStatusResponse, type DeviceSupportFlags, type DeviceType, type DiagnosticsCollectorResult, type DiagnosticsStreamKind, type DiscoveredDevice, type DiscoveryOptions, type DownloadRecordingParams, type DualLensChannelAnalysis, type DualLensChannelInfo, type EmailTaskConfig, type EncryptionProtocol, type Events, type EventsResponse, type FloodlightTaskConfig, type FtpTaskConfig, type GetRecordingVideoResult, type GetRecordingVideoStats, type GetVideoclipsParams, type GetVodUrlParams, H264RtpDepacketizer, H265RtpDepacketizer, type HardwiredChimeState, type HddInfoListConfig, type HlsCodec, type HlsHttpResponse, type HlsServerStatus, type HlsSession, HlsSessionManager, type HlsSessionManagerOptions, type HlsSessionParams, Intercom, type IntercomOptions, type JsonObject, type JsonPrimitive, type JsonValue, type LastSleepProbe, type LogLevel, type Logger, type LoggerCallback, type LoginResponseValue, type MaxEncryption, type MediaStream, type MjpegFrame, MjpegTransformer, type MjpegTransformerOptions, type MotionAlarmConfig, type MotionEvent, NVR_HUB_EXACT_TYPES, NVR_HUB_MODEL_PATTERNS, type NativeVideoStreamVariant, type NvrChannelsSummaryCacheEntry, type OnlineUserListConfig, type OsdChannel, type OsdConfig, type OsdTime, type ParsedRecordingFileName, type PipPosition, type PirConfig, type PirState, type PlaybackSnapshotStreamInfo, type PtzCommand, type PtzPosition, type PtzPreset, type RecEncConfig, type RecordingAudioCodec, type RecordingDetectionClass, type RecordingDevType, type RecordingFile, type RecordingPlaybackUrls, type RecordingStreamType, type RecordingVideoCodec, type RecordingVodFlags, type RecordingVodStreamHint, type RecordingsCacheEntry, type RecordingsQueueItem, type ReolinkAiNotification, ReolinkBaichuanApi, type ReolinkBaichuanChannelIdentity, type ReolinkBaichuanChannelInfo, type ReolinkBaichuanDeviceSummary, type ReolinkBaichuanNetworkInfo, type ReolinkBaichuanPorts, ReolinkCgiApi, type ReolinkCmdRequest, type ReolinkCmdResponse, type ReolinkCmdResponseExt, type ReolinkDayNightNotification, type ReolinkDeviceInfo, type ReolinkDeviceInfoTag, type ReolinkEvent, ReolinkHttpClient, type ReolinkHttpClientOptions, type ReolinkJson, type ReolinkMotionNotification, type ReolinkNvrChannelInfo, type ReolinkNvrDeviceGroupSummary, type ReolinkNvrDeviceGroupsResult, type ReolinkSimpleEvent, type ReolinkSimpleEventType, type ReolinkSupportedStream, type ReolinkVideoStreamOptionsResult, type ReolinkVisitorNotification, type ReplayHttpServer, type ReplayHttpServerOptions, type ResponseMediaStreamOptions, type Rfc4571ApiFactoryContext, type Rfc4571Client, Rfc4571Muxer, type Rfc4571ReplayServer, type Rfc4571ReplayServerOptions, type Rfc4571TcpServer, type Rfc4571TcpServerOptions, type RtpPacketizationOptions, type RtspCreateOptions, type RtspProxyServerOptions, type RtspStreamProfile, type RunAllDiagnosticsConsecutivelyParams, type RunAllDiagnosticsConsecutivelyResult, type RunMultifocalDiagnosticsConsecutivelyParams, type RunMultifocalDiagnosticsConsecutivelyResult, type SirenState, type SirenStatusConfig, type SleepState, type SleepStatus, type StreamMetadata, type StreamProfile, type StreamSamplingOptions, type StreamSamplingSelection, type SupportConfig, type SupportInfo, type SupportItem, type SystemGeneralConfig, type TalkAbility$1 as TalkAbility, type TalkAudioConfig, type TalkConfig, type TalkSession$1 as TalkSession, type TalkSessionInfo, type TimelapseCfgConfig, type TwoWayAudioConfig, type VideoCodec, type VideoInputConfig, type VideoParamSets, type VideoStreamOptions, type VideoStreamOptionsCacheEntry, type VideoType, type VideoclipClientInfo, type VideoclipModeDecision, type VideoclipThumbnailResult, type VideoclipTranscodeMode, type VodFile, type VodSearchResponse, type VodSearchResult, type VodSearchStatus, type WakeUpOptions, type WebRTCAnswer, type WebRTCIceCandidate, type WebRTCOffer, type WebRTCSessionInfo, type WhiteLedConfig, type WhiteLedState, type WirelessChimeSilentState, type ZoomFocusStatus, type ZoomFocusTriplet, abilitiesHasAny, aesDecrypt, aesEncrypt, asLogger, autoDetectDeviceType, bcDecrypt, bcEncrypt, bcHeaderHasPayloadOffset, buildAacAudioSpecificConfigHex, buildAbilityInfoExtensionXml, buildBinaryExtensionXml, buildChannelExtensionXml, buildFloodlightManualXml, buildHlsRedirectUrl, buildLoginXml, buildLogoutXml, buildPreviewStopXml, buildPreviewStopXmlV11, buildPreviewXml, buildPreviewXmlV11, buildPtzControlXml, buildPtzPresetXml, buildPtzPresetXmlV2, buildRfc4571Sdp, buildRtspPath, buildRtspUrl, buildSirenManualXml, buildSirenTimesXml, buildStartZoomFocusXml, buildWhiteLedStateXml, collectCgiDiagnostics, collectMultifocalDiagnostics, collectNativeDiagnostics, collectNvrDiagnostics, computeDeviceCapabilities, convertToAnnexB as convertH265ToAnnexB, convertToAnnexB$1 as convertToAnnexB, convertToLengthPrefixed, createBaichuanEndpointsServer, createDebugGateLogger, createDiagnosticsBundle, createLogger, createMjpegBoundary, createNativeStream, createNullLogger, createReplayHttpServer, createRfc4571TcpServer, createRfc4571TcpServerForReplay, createRtspProxyServer, createTaggedLogger, decideVideoclipTranscodeMode, decodeHeader, deriveAesKey, detectIosClient, detectVideoCodecFromNal, discoverReolinkDevices, discoverViaArpTable, discoverViaDhcpListener, discoverViaHttpScan, discoverViaOnvif, discoverViaTcpPortScan, discoverViaUdpBroadcast, discoverViaUdpDirect, encodeHeader, extractH264ParamSetsFromAccessUnit, extractH265ParamSetsFromAccessUnit, extractPpsFromAnnexB, extractSpsFromAnnexB, extractVpsFromAnnexB, flattenAbilitiesForChannel, formatMjpegFrame, getConstructedVideoStreamOptions, getGlobalLogger, getH265NalType, getMjpegContentType, getSupportItemForChannel, getVideoStream, getVideoclipClientInfo, getXmlText, hasStartCodes as hasH265StartCodes, hasStartCodes$1 as hasStartCodes, isDualLenseModel, isH264KeyframeAnnexB, isH265Irap, isH265KeyframeAnnexB, isNvrHubModel, isTcpFailureThatShouldFallbackToUdp, isValidH264AnnexBAccessUnit, isValidH265AnnexBAccessUnit, maskUid, md5HexUpper, md5StrModern, normalizeUid, packetizeAacAdtsFrame, packetizeAacRawFrame, packetizeH264, packetizeH265, parseAdtsHeader, parseBcMedia, parseRecordingFileName, parseSupportXml, printNvrDiagnostics, runAllDiagnosticsConsecutively, runMultifocalDiagnosticsConsecutively, sampleStreams, setGlobalLogger, splitAnnexBToNalPayloads$1 as splitAnnexBToNalPayloads, splitAnnexBToNals, splitAnnexBToNalPayloads as splitH265AnnexBToNalPayloads, testChannelStreams, xmlEscape, zipDirectory };
+export { type AIDetectionState, type AIEvent, type AIState, type AbilityInfo, type AccessUserListConfig, AesStreamDecryptor, type AiAlarmConfig, type AiConfig, type AiDenoiseConfig, type AiKey, type AiTypesCacheEntry, type AnyBuffer, type AudioAlarmParams, type AudioCfgConfig, type AudioConfig, type AudioTaskConfig, type AutoDetectInputs, type AutoDetectMode, type AutoDetectResult, AutodiscoveryClient, type AutodiscoveryClientOptions, BC_AES_IV, BC_CLASS_FILE_DOWNLOAD, BC_CLASS_LEGACY, BC_CLASS_MODERN_20, BC_CLASS_MODERN_24, BC_CLASS_MODERN_24_ALT, BC_CMD_ID_ABILITY_INFO, BC_CMD_ID_ALARM_EVENT_LIST, BC_CMD_ID_AUDIO_ALARM_PLAY, BC_CMD_ID_CHANNEL_INFO_ALL, BC_CMD_ID_CMD_123, BC_CMD_ID_CMD_209, BC_CMD_ID_CMD_265, BC_CMD_ID_CMD_440, BC_CMD_ID_COVER_PREVIEW, BC_CMD_ID_COVER_RESPONSE, BC_CMD_ID_COVER_STANDALONE_458, BC_CMD_ID_COVER_STANDALONE_459, BC_CMD_ID_COVER_STANDALONE_460, BC_CMD_ID_COVER_STANDALONE_461, BC_CMD_ID_COVER_STANDALONE_462, BC_CMD_ID_DING_DONG_CTRL, BC_CMD_ID_DING_DONG_OPT, BC_CMD_ID_FILE_INFO_LIST_CLOSE, BC_CMD_ID_FILE_INFO_LIST_DL_VIDEO, BC_CMD_ID_FILE_INFO_LIST_DOWNLOAD, BC_CMD_ID_FILE_INFO_LIST_GET, BC_CMD_ID_FILE_INFO_LIST_OPEN, BC_CMD_ID_FILE_INFO_LIST_REPLAY, BC_CMD_ID_FILE_INFO_LIST_STOP, BC_CMD_ID_FIND_REC_VIDEO_CLOSE, BC_CMD_ID_FIND_REC_VIDEO_GET, BC_CMD_ID_FIND_REC_VIDEO_OPEN, BC_CMD_ID_FLOODLIGHT_STATUS_LIST, BC_CMD_ID_GET_ABILITY_SUPPORT, BC_CMD_ID_GET_ACCESS_USER_LIST, BC_CMD_ID_GET_AI_ALARM, BC_CMD_ID_GET_AI_CFG, BC_CMD_ID_GET_AI_DENOISE, BC_CMD_ID_GET_AUDIO_ALARM, BC_CMD_ID_GET_AUDIO_CFG, BC_CMD_ID_GET_AUDIO_TASK, BC_CMD_ID_GET_BATTERY_INFO, BC_CMD_ID_GET_BATTERY_INFO_LIST, BC_CMD_ID_GET_DAY_NIGHT_THRESHOLD, BC_CMD_ID_GET_DAY_RECORDS, BC_CMD_ID_GET_DING_DONG_CFG, BC_CMD_ID_GET_DING_DONG_LIST, BC_CMD_ID_GET_DING_DONG_SILENT, BC_CMD_ID_GET_EMAIL_TASK, BC_CMD_ID_GET_FTP_TASK, BC_CMD_ID_GET_HDD_INFO_LIST, BC_CMD_ID_GET_KIT_AP_CFG, BC_CMD_ID_GET_LED_STATE, BC_CMD_ID_GET_MOTION_ALARM, BC_CMD_ID_GET_ONLINE_USER_LIST, BC_CMD_ID_GET_OSD_DATETIME, BC_CMD_ID_GET_PIR_INFO, BC_CMD_ID_GET_PTZ_POSITION, BC_CMD_ID_GET_PTZ_PRESET, BC_CMD_ID_GET_RECORD, BC_CMD_ID_GET_RECORD_CFG, BC_CMD_ID_GET_REC_ENC_CFG, BC_CMD_ID_GET_SIREN_STATUS, BC_CMD_ID_GET_SLEEP_STATE, BC_CMD_ID_GET_STREAM_INFO_LIST, BC_CMD_ID_GET_SUPPORT, BC_CMD_ID_GET_SYSTEM_GENERAL, BC_CMD_ID_GET_TIMELAPSE_CFG, BC_CMD_ID_GET_VIDEO_INPUT, BC_CMD_ID_GET_WHITE_LED, BC_CMD_ID_GET_WIFI, BC_CMD_ID_GET_WIFI_SIGNAL, BC_CMD_ID_GET_ZOOM_FOCUS, BC_CMD_ID_LOGIN, BC_CMD_ID_LOGOUT, BC_CMD_ID_PING, BC_CMD_ID_PTZ_CONTROL, BC_CMD_ID_PTZ_CONTROL_PRESET, BC_CMD_ID_PUSH_COORDINATE_POINT_LIST, BC_CMD_ID_PUSH_DINGDONG_LIST, BC_CMD_ID_PUSH_NET_INFO, BC_CMD_ID_PUSH_SERIAL, BC_CMD_ID_PUSH_SLEEP_STATUS, BC_CMD_ID_PUSH_VIDEO_INPUT, BC_CMD_ID_QUICK_REPLY_PLAY, BC_CMD_ID_SET_AI_ALARM, BC_CMD_ID_SET_AI_CFG, BC_CMD_ID_SET_AUDIO_TASK, BC_CMD_ID_SET_DING_DONG_CFG, BC_CMD_ID_SET_DING_DONG_SILENT, BC_CMD_ID_SET_MOTION_ALARM, BC_CMD_ID_SET_PIR_INFO, BC_CMD_ID_SET_WHITE_LED_STATE, BC_CMD_ID_SET_WHITE_LED_TASK, BC_CMD_ID_SET_ZOOM_FOCUS, BC_CMD_ID_SUPPORT, BC_CMD_ID_TALK, BC_CMD_ID_TALK_ABILITY, BC_CMD_ID_TALK_CONFIG, BC_CMD_ID_TALK_RESET, BC_CMD_ID_UDP_KEEP_ALIVE, BC_CMD_ID_VIDEO, BC_CMD_ID_VIDEO_STOP, BC_MAGIC, BC_MAGIC_REV, BC_TCP_DEFAULT_PORT, BC_XML_KEY, type BaichuanCachedPush, BaichuanClient, type BaichuanClientOptions, type BaichuanCoordinatePointListPush, type BaichuanDingdongListPush, type BaichuanEndpointsServerOptions, BaichuanEventEmitter, type BaichuanFrame, BaichuanFrameParser, type BaichuanGetOsdDatetimeResult, type BaichuanHeader, BaichuanHlsServer, type BaichuanHlsServerOptions, BaichuanHttpStreamServer, type BaichuanHttpStreamServerOptions, type BaichuanLedState, BaichuanMjpegServer, type BaichuanMjpegServerOptions, type BaichuanNetInfoPush, type BaichuanOsdChannelName, type BaichuanOsdDatetime, type BaichuanRecordCfg, type BaichuanRecordSchedule, BaichuanRtspServer, type BaichuanRtspServerOptions, type BaichuanSerialPush, type BaichuanSettingsPushCacheEntry, type BaichuanSleepState, type BaichuanSleepStatusPush, type BaichuanStreamEncodeTable, type BaichuanStreamInfo, type BaichuanStreamInfoList, type BaichuanTransport, type BaichuanVideoInputPush, BaichuanVideoStream, type BaichuanVideoStreamOptions, BaichuanWebRTCServer, type BaichuanWebRTCServerOptions, type BaichuanWifi, type BaichuanWifiSignal, type BatteryInfo, type BatteryInfoResponse, type BcMedia, type BcMediaAac, type BcMediaAdpcm, BcMediaAnnexBDecoder, type BcMediaAnnexBDecoderStats, type BcMediaAnnexBInfo, type BcMediaAudioFrame, type BcMediaAudioType, BcMediaCodec, type BcMediaIframe, type BcMediaInfoV1, type BcMediaInfoV2, type BcMediaPframe, type BcMediaType, type BcMediaVideoFrame, type BcMediaVideoType, type BcUdpDiscoveryMethod, BcUdpStream, type BcUdpStreamOptions, type CgiAbility, type CgiAbilityChn, type CgiAbilityLeaf, type CgiAiKey, type CgiAiStateValue, type CgiAudioAlarmPlayParam, type CgiBattery, type CgiChannelStatusEntry, type CgiChnTypeInfoValue, type CgiDetectionState, type CgiDevInfo, type CgiDeviceInfoEntries, type CgiEnc, type CgiEncStream, type CgiEncValue, type CgiGetAbilityResponse, type CgiGetAbilityValue, type CgiGetAiStateResponse, type CgiGetChannelstatusResponse, type CgiGetChannelstatusValue, type CgiGetChnTypeInfoResponse, type CgiGetDevInfoResponse, type CgiGetDevInfoValue, type CgiGetEncResponse, type CgiGetOsdValue, type CgiGetRtspUrlResponse, type CgiGetRtspUrlValue, type CgiGetVideoclipsParams, type CgiNetPort, type CgiOsd, type CgiPirInfo, type CgiPtzPreset, type CgiSetOsdParam, type CgiSetPirInfoParam, type CgiSetWhiteLedParam, type CgiWhiteLed, type ChannelPushCacheEntry, type ChannelPushDataEntry, type ChannelRecordingFile, type ChannelStreamMetadata, type ChimeAlarmCfg, type ChimeCfg, type ChimeDevice, type ChimeParams, type CollectNvrDiagnosticsOptions, CompositeRtspServer, type CompositeRtspServerOptions, CompositeStream, type CompositeStreamOptions, type CompositeStreamPipOptions, DUAL_LENS_DUAL_MOTION_MODELS, DUAL_LENS_MODELS, DUAL_LENS_SINGLE_MOTION_MODELS, type DayNightThresholdConfig, type DebugConfig, type DebugOptions, type DeviceAbilities, type DeviceCapabilities, type DeviceCapabilitiesCacheEntry, type DeviceCapabilitiesDebugInfo, type DeviceCapabilitiesResult, type DeviceInfoResponse, type DeviceInputData, type DeviceObjectType, type DeviceStatusResponse, type DeviceSupportFlags, type DeviceType, type DiagnosticsCollectorResult, type DiagnosticsStreamKind, type DiscoveredDevice, type DiscoveryOptions, type DownloadRecordingParams, type DualLensChannelAnalysis, type DualLensChannelInfo, type EmailTaskConfig, type EncryptionProtocol, type Events, type EventsResponse, type FloodlightTaskConfig, type FtpTaskConfig, type GetRecordingVideoResult, type GetRecordingVideoStats, type GetVideoclipsParams, type GetVodUrlParams, Go2rtcTcpServer, type Go2rtcTcpServerOptions, H264RtpDepacketizer, H265RtpDepacketizer, type HardwiredChimeState, type HddInfoListConfig, type HlsCodec, type HlsHttpResponse, type HlsServerStatus, type HlsSession, HlsSessionManager, type HlsSessionManagerOptions, type HlsSessionParams, Intercom, type IntercomOptions, type JsonObject, type JsonPrimitive, type JsonValue, type LastSleepProbe, type LogLevel, type Logger, type LoggerCallback, type LoginResponseValue, type MaxEncryption, type MediaStream, type MjpegFrame, MjpegTransformer, type MjpegTransformerOptions, type ModelFixtureCaptureResult, type MotionAlarmConfig, type MotionEvent, NVR_HUB_EXACT_TYPES, NVR_HUB_MODEL_PATTERNS, type NativeVideoStreamVariant, type NvrChannelsSummaryCacheEntry, type OnlineUserListConfig, type OsdChannel, type OsdConfig, type OsdTime, type ParsedRecordingFileName, type PipPosition, type PirConfig, type PirState, type PlaybackSnapshotStreamInfo, type PtzCommand, type PtzPosition, type PtzPreset, type RecEncConfig, type RecordingAudioCodec, type RecordingDetectionClass, type RecordingDevType, type RecordingFile, type RecordingPlaybackUrls, type RecordingStreamType, type RecordingVideoCodec, type RecordingVodFlags, type RecordingVodStreamHint, type RecordingsCacheEntry, type RecordingsQueueItem, type ReolinkAiNotification, ReolinkBaichuanApi, type ReolinkBaichuanChannelIdentity, type ReolinkBaichuanChannelInfo, type ReolinkBaichuanDeviceSummary, type ReolinkBaichuanNetworkInfo, type ReolinkBaichuanPorts, ReolinkCgiApi, type ReolinkCmdRequest, type ReolinkCmdResponse, type ReolinkCmdResponseExt, type ReolinkDayNightNotification, type ReolinkDeviceInfo, type ReolinkDeviceInfoTag, type ReolinkEvent, ReolinkHttpClient, type ReolinkHttpClientOptions, type ReolinkJson, type ReolinkMotionNotification, type ReolinkNvrChannelInfo, type ReolinkNvrDeviceGroupSummary, type ReolinkNvrDeviceGroupsResult, type ReolinkSimpleEvent, type ReolinkSimpleEventType, type ReolinkSupportedStream, type ReolinkVideoStreamOptionsResult, type ReolinkVisitorNotification, type ReplayHttpServer, type ReplayHttpServerOptions, type ResponseMediaStreamOptions, type Rfc4571ApiFactoryContext, type Rfc4571Client, Rfc4571Muxer, type Rfc4571ReplayServer, type Rfc4571ReplayServerOptions, type Rfc4571TcpServer, type Rfc4571TcpServerOptions, type RtpPacketizationOptions, type RtspCreateOptions, type RtspProxyServerOptions, type RtspStreamProfile, type RunAllDiagnosticsConsecutivelyParams, type RunAllDiagnosticsConsecutivelyResult, type RunMultifocalDiagnosticsConsecutivelyParams, type RunMultifocalDiagnosticsConsecutivelyResult, type SirenState, type SirenStatusConfig, type SleepState, type SleepStatus, type StreamMetadata, type StreamProfile, type StreamSamplingOptions, type StreamSamplingSelection, type SupportConfig, type SupportInfo, type SupportItem, type SystemGeneralConfig, type TalkAbility$1 as TalkAbility, type TalkAudioConfig, type TalkConfig, type TalkSession$1 as TalkSession, type TalkSessionInfo, type TimelapseCfgConfig, type TwoWayAudioConfig, type VideoCodec, type VideoInputConfig, type VideoParamSets, type VideoStreamOptions, type VideoStreamOptionsCacheEntry, type VideoType, type VideoclipClientInfo, type VideoclipModeDecision, type VideoclipThumbnailResult, type VideoclipTranscodeMode, type VodFile, type VodSearchResponse, type VodSearchResult, type VodSearchStatus, type WakeUpOptions, type WebRTCAnswer, type WebRTCIceCandidate, type WebRTCOffer, type WebRTCSessionInfo, type WhiteLedConfig, type WhiteLedState, type WirelessChimeSilentState, type ZoomFocusStatus, type ZoomFocusTriplet, abilitiesHasAny, aesDecrypt, aesEncrypt, asLogger, autoDetectDeviceType, bcDecrypt, bcEncrypt, bcHeaderHasPayloadOffset, buildAacAudioSpecificConfigHex, buildAbilityInfoExtensionXml, buildBinaryExtensionXml, buildChannelExtensionXml, buildFloodlightManualXml, buildHlsRedirectUrl, buildLoginXml, buildLogoutXml, buildPreviewStopXml, buildPreviewStopXmlV11, buildPreviewXml, buildPreviewXmlV11, buildPtzControlXml, buildPtzPresetXml, buildPtzPresetXmlV2, buildRfc4571Sdp, buildRtspPath, buildRtspUrl, buildSirenManualXml, buildSirenTimesXml, buildStartZoomFocusXml, buildWhiteLedStateXml, captureModelFixtures, collectCgiDiagnostics, collectMultifocalDiagnostics, collectNativeDiagnostics, collectNvrDiagnostics, computeDeviceCapabilities, convertToAnnexB as convertH265ToAnnexB, convertToAnnexB$1 as convertToAnnexB, convertToLengthPrefixed, createBaichuanEndpointsServer, createDebugGateLogger, createDiagnosticsBundle, createLogger, createMjpegBoundary, createNativeStream, createNullLogger, createReplayHttpServer, createRfc4571TcpServer, createRfc4571TcpServerForReplay, createRtspProxyServer, createTaggedLogger, decideVideoclipTranscodeMode, decodeHeader, deriveAesKey, detectIosClient, detectVideoCodecFromNal, discoverReolinkDevices, discoverViaArpTable, discoverViaDhcpListener, discoverViaHttpScan, discoverViaOnvif, discoverViaTcpPortScan, discoverViaUdpBroadcast, discoverViaUdpDirect, encodeHeader, extractH264ParamSetsFromAccessUnit, extractH265ParamSetsFromAccessUnit, extractPpsFromAnnexB, extractSpsFromAnnexB, extractVpsFromAnnexB, flattenAbilitiesForChannel, formatMjpegFrame, getConstructedVideoStreamOptions, getGlobalLogger, getH265NalType, getMjpegContentType, getSupportItemForChannel, getVideoStream, getVideoclipClientInfo, getXmlText, hasStartCodes as hasH265StartCodes, hasStartCodes$1 as hasStartCodes, isDualLenseModel, isH264KeyframeAnnexB, isH265Irap, isH265KeyframeAnnexB, isNvrHubModel, isTcpFailureThatShouldFallbackToUdp, isValidH264AnnexBAccessUnit, isValidH265AnnexBAccessUnit, maskUid, md5HexUpper, md5StrModern, normalizeUid, packetizeAacAdtsFrame, packetizeAacRawFrame, packetizeH264, packetizeH265, parseAdtsHeader, parseBcMedia, parseRecordingFileName, parseSupportXml, printNvrDiagnostics, runAllDiagnosticsConsecutively, runMultifocalDiagnosticsConsecutively, sampleStreams, setGlobalLogger, splitAnnexBToNalPayloads$1 as splitAnnexBToNalPayloads, splitAnnexBToNals, splitAnnexBToNalPayloads as splitH265AnnexBToNalPayloads, testChannelStreams, xmlEscape, xmlIndicatesFloodlight, zipDirectory };

package/dist/index.d.ts

@@ -422,6 +422,22 @@ export declare class BaichuanClient extends EventEmitter<{
     private static readonly coverPreviewBackoffMs;
     private static readonly COVER_PREVIEW_INITIAL_BACKOFF_MS;
     private static readonly COVER_PREVIEW_MAX_BACKOFF_MS;
+    /**
+     * Per-client snapshot (cmd_id=109) serialization queue.
+     *
+     * WHY: On NVR/multi-camera devices sharing one socket, concurrent snapshot requests
+     * can cause JPEG data to mix (even with per-request msgNum filtering):
+     * - Camera A and B both send frames on same socket
+     * - Frame listener is global per socket
+     * - Timing quirks can cause chunk reordering or listener confusion
+     *
+     * FIX: Serialize all cmd_id=109 requests on THIS client instance.
+     * Each snapshot waits for previous one to complete before starting.
+     * This ensures clean frame sequences per request, zero data corruption.
+     *
+     * Impact: Snapshots are ~0–50ms slower per camera (negligible for users).
+     */
+    private snapshotQueueTail;
     private readonly opts;
     private readonly debugCfg;
     private readonly logger;
@@ -768,6 +784,7 @@ export declare class BaichuanClient extends EventEmitter<{
     private sendBinaryFileDownload6482;
     private sendBinaryFileInfoListReplay5;
     private sendBinarySnapshot109;
+    private sendBinarySnapshot109Impl;
     /**
      * Send CoverPreview command (cmd_id=298) to get an I-frame from a past recording.
      * Similar to sendBinarySnapshot109 but handles the stream header + frame format
@@ -2487,6 +2504,24 @@ export declare function buildStartZoomFocusXml(channelId: number, movePos: numbe
  */
 export declare function buildWhiteLedStateXml(channelId: number, state: number): string;
 
+/**
+ * Capture all relevant API responses from a single device (or NVR channel)
+ * and write them as JSON/XML fixtures into `outDir`.
+ *
+ * This is the library-level building block used by both:
+ *   - `test/capture-model-fixtures.ts` (CLI)
+ *   - the Scrypted plugin's "Dump Model Fixtures" setting action
+ *
+ * For NVR/Hub devices, call once per active channel.
+ */
+export declare function captureModelFixtures(params: {
+    api: ReolinkBaichuanApi;
+    channel: number;
+    outDir: string;
+    /** Logger (defaults to console) */
+    log?: (...args: unknown[]) => void;
+}): Promise<ModelFixtureCaptureResult>;
+
 export declare type CgiAbility = {
     Ability: {
         abilityChn?: CgiAbilityChn[];
@@ -4040,6 +4075,104 @@ export declare interface GetVodUrlParams {
  */
 export declare function getXmlText(xml: string, tagName: string): string | undefined;
 
+export declare class Go2rtcTcpServer extends EventEmitter<{
+    client: [string];
+    clientDisconnected: [string];
+    error: [Error];
+    close: [];
+    listening: [{
+        host: string;
+        port: number;
+    }];
+}> {
+    private readonly api;
+    private readonly channel;
+    private readonly profile;
+    private readonly variant;
+    private readonly listenHost;
+    private readonly listenPort;
+    private readonly logger;
+    private readonly deviceId;
+    private readonly gracePeriodMs;
+    private readonly prebufferMaxMs;
+    private readonly maxBufferBytes;
+    private readonly prestartStream;
+    private active;
+    private server;
+    private resolvedPort;
+    private nativeFanout;
+    private nativeStreamActive;
+    private dedicatedSessionRelease;
+    private detectedVideoType;
+    private connectedClients;
+    private clientSockets;
+    private stopGraceTimer;
+    private prebuffer;
+    constructor(options: Go2rtcTcpServerOptions);
+    /** Start listening. Resolves once the TCP server is bound. */
+    start(): Promise<void>;
+    /** Stop the server and all active streams. */
+    stop(): Promise<void>;
+    /** The actual port the server is listening on (available after start()). */
+    get port(): number | undefined;
+    /** The go2rtc-compatible source URL. */
+    get go2rtcSourceUrl(): string | undefined;
+    /** Number of currently connected clients. */
+    get clientCount(): number;
+    private handleClient;
+    private feedClient;
+    /**
+     * Convert a native frame to wire-ready Annex-B.
+     * Audio frames are skipped — raw TCP carries only video (Annex-B).
+     * go2rtc auto-detects the codec from SPS/PPS/VPS NALUs.
+     */
+    private convertFrame;
+    /** Check if an Annex-B buffer contains a keyframe (IDR for H.264, IRAP for H.265). */
+    private isAnnexBKeyframe;
+    /** Split Annex-B byte stream into individual NAL units. */
+    private static splitAnnexBNals;
+    private startNativeStream;
+    private stopNativeStream;
+    private removeClient;
+    private scheduleStop;
+}
+
+export declare interface Go2rtcTcpServerOptions {
+    /** API instance (required). */
+    api: ReolinkBaichuanApi;
+    /** Channel number (required). */
+    channel: number;
+    /** Stream profile (required). */
+    profile: StreamProfile;
+    /** TrackMix tele/autotrack variant. */
+    variant?: NativeVideoStreamVariant;
+    /** Host to listen on (default: "127.0.0.1"). */
+    listenHost?: string;
+    /** Port to listen on (default: 0 = OS picks). */
+    listenPort?: number;
+    /** Logger. */
+    logger?: Logger;
+    /**
+     * External identifier for dedicated socket session.
+     * When provided, a dedicated BaichuanClient is created for the stream,
+     * isolating it from other streams on the shared socket.
+     */
+    deviceId?: string;
+    /** Grace period in ms before stopping native stream after last client disconnects (default: 30 000). */
+    gracePeriodMs?: number;
+    /** Maximum prebuffer window in ms (default: 3 000). */
+    prebufferMs?: number;
+    /** Maximum write buffer per client before dropping the connection (default: 100 MB). */
+    maxBufferBytes?: number;
+    /**
+     * When true, the native camera stream is started immediately on start()
+     * rather than waiting for the first TCP client. This ensures frames are
+     * already flowing (and the prebuffer is warm) when go2rtc connects.
+     * Default: true.
+     */
+    prestartStream?: boolean;
+}
+
 /**
  * Depacketizer for H.264 "RTP-like" payloads (RFC 6184) when the camera sends single NAL units,
  * STAP/MTAP aggregation or FU-A/FU-B fragmentation inside a BcMedia frame payload.
@@ -4482,6 +4615,26 @@ export declare interface MjpegTransformerOptions {
     logger?: LoggerCallback | undefined;
 }
 
+export declare interface ModelFixtureCaptureResult {
+    /** Per-call results: command name → ok/error */
+    calls: Record<string, {
+        ok: true;
+        value?: unknown;
+    } | {
+        ok: false;
+        error: string;
+    }>;
+    /** Output directory where fixtures were written */
+    outDir: string;
+    /** Summary counters */
+    summary: {
+        total: number;
+        ok: number;
+        failed: number;
+        errors: string[];
+    };
+}
+
 /**
  * Motion alarm configuration (getMotionAlarm response).
  * cmdId=46 (GetMdAlarm)
@@ -9064,6 +9217,18 @@ export declare interface WirelessChimeSilentState {
 
 export declare function xmlEscape(text: string | undefined | null): string;
 
+/**
+ * Determine whether a cmd 289 (GetWhiteLed) XML response indicates
+ * controllable floodlight/spotlight hardware.
+ *
+ * `<FloodlightTask>`, `<FloodlightManual>`, and `<FloodlightStatusList>` are
+ * conclusive.  `<WhiteLed>` is ambiguous — doorbells (e.g. D340W) return it
+ * for their status-indicator LED which is NOT a floodlight.  Only treat
+ * `<WhiteLed>` as floodlight when brightness or scheduling controls are
+ * present (`brightness_cur`, `bright`, `LightingSchedule`).
+ */
+export declare function xmlIndicatesFloodlight(xml: string): boolean;
+
 declare type XmlJsonObject = {
     [key: string]: XmlJsonValue;
 };