@apocaliss92/nodelink-js 0.5.1 → 0.6.0

package/dist/index.d.cts

@@ -86,6 +86,8 @@ declare const BC_CMD_ID_FLOODLIGHT_STATUS_LIST = 291;
 declare const BC_CMD_ID_ABILITY_INFO = 151;
 declare const BC_CMD_ID_SUPPORT = 199;
 declare const BC_CMD_ID_PING = 93;
+declare const BC_CMD_ID_DEVICE_DETECT_CANDIDATES: readonly [31, 132, 150];
+declare const BC_CMD_ID_DEVICE_DETECT: number | null;
 declare const BC_CMD_ID_GET_SNAPSHOT = 109;
 declare const BC_CMD_ID_GET_UID = 114;
 declare const BC_CMD_ID_CHANNEL_INFO_ALL = 145;
@@ -3060,6 +3062,15 @@ type BcUdpStreamOptions = {
      * - `relay`: fully relayed via Reolink servers
      */
     discoveryMethod?: BcUdpDiscoveryMethod;
+    /**
+     * Override the default 15s timeout on local-direct / local-broadcast
+     * BCUDP discovery (the time we'll wait for a camera reply after
+     * sending C2D_S probes). Battery cams that are awake reply in
+     * 1-5s — keeping the default short collapses the user-visible
+     * failure path for off-LAN / sleeping cameras. Raise this only
+     * for pathologically slow LANs where 15s is genuinely not enough.
+     */
+    localDiscoveryTimeoutMs?: number;
 } | {
     /** Direct connection with already-known parameters. */
     mode: "direct";
@@ -3088,6 +3099,16 @@ declare class BcUdpStream extends EventEmitter<{
     debug: [string, unknown?];
 }> {
     private readonly opts;
+    /**
+     * Optional info-level logger for diagnostic milestones — set via
+     * {@link BcUdpStream.setLogger} by `BaichuanClient` so the lib's
+     * standard logger sink sees BCUDP / P2P progress (DNS resolutions,
+     * outgoing UDP probes, timeouts with elapsed times) without the user
+     * having to opt into the per-packet `debug` event firehose. Kept
+     * separate from `emit('debug', ...)` because that channel is intended
+     * for the per-packet debug trace and is gated by debugOptions.
+     */
+    private discoveryLogger;
     private sock;
     private remote?;
     private mtu;
@@ -3115,6 +3136,15 @@ declare class BcUdpStream extends EventEmitter<{
     private getKeepAliveTid;
     constructor(options: BcUdpStreamOptions);
     /** True if the underlying UDP socket is open and the remote peer is known. */
+    /**
+     * Attach an info-level logger for high-signal diagnostic milestones
+     * (DNS resolution, outgoing UDP probe sends, P2P UID lookup wins/losses,
+     * BCUDP local discovery timeouts). The lib's `BaichuanClient` calls
+     * this immediately after constructing the stream so consumers get
+     * actionable progress logs without enabling the per-packet debug trace.
+     * Safe to call repeatedly; only the most recent logger is used.
+     */
+    setLogger(logger: Logger | undefined): void;
     isConnected(): boolean;
     connect(): Promise<void>;
     private discoveryUid;
@@ -5254,6 +5284,88 @@ interface CompositeStreamPipOptions {
     teleRtspUrl?: string;
     /** ffmpeg `-rtsp_transport` value (default: tcp). */
     rtspTransport?: 'tcp' | 'udp';
+    /**
+     * Absolute path to the `ffmpeg` binary the compositor should `spawn()`.
+     *
+     * When unset, falls back to the bare string `"ffmpeg"`, which relies on
+     * the host's `PATH`. This works on standard Linux / macOS Node setups
+     * but fails silently on environments where the embedding process
+     * strips PATH or ships its own ffmpeg in a non-discoverable location:
+     *
+     *  - Scrypted on Windows (the Electron host launches plugins with a
+     *    minimal PATH; the bundled ffmpeg lives at a static absolute path
+     *    only `sdk.mediaManager.getFFmpegPath()` knows about).
+     *  - Scrypted on macOS App Store / sandboxed installs.
+     *  - Distroless / minimal Docker base images where ffmpeg is mounted
+     *    at a fixed path but not in PATH.
+     *
+     * Consumers in any of those environments should resolve the path
+     * themselves (e.g. via the Scrypted SDK) and pass it through here.
+     */
+    ffmpegPath?: string;
+    /**
+     * Output video encoder name (passed verbatim as `-c:v`). Default
+     * `libx264` — pure software. On a host with hardware-accelerated
+     * H.264 encoding, switching this is the single biggest perf win
+     * available (5-10x less CPU for the same output bitrate). Supported
+     * by ffmpeg in the wild:
+     *
+     *  - Intel/AMD QuickSync:  `h264_qsv`
+     *  - Intel/AMD VAAPI:      `h264_vaapi`
+     *  - NVIDIA NVENC:         `h264_nvenc`
+     *  - Apple VideoToolbox:   `h264_videotoolbox`
+     *  - Raspberry Pi / ARM:   `h264_v4l2m2m`
+     *
+     * Caveat: when not `libx264`, the libx264-specific knobs
+     * (`encoderPreset`, `crf`, `x264-params`) are silently dropped because
+     * each HW encoder has its own option vocabulary. Use
+     * {@link extraOutputArgs} to pass encoder-specific options
+     * (e.g. `["-q:v","23"]` for QSV, `["-preset","fast"]` for NVENC).
+     */
+    videoEncoder?: string;
+    /**
+     * libx264 preset (default `ultrafast`). Only consulted when
+     * {@link videoEncoder} is left at its default (libx264). Valid:
+     * `ultrafast | superfast | veryfast | faster | fast | medium | slow |
+     * slower | veryslow | placebo`. Slower = better compression / more CPU.
+     */
+    encoderPreset?: string;
+    /**
+     * CRF (constant rate factor) for libx264. Default 23 (visually
+     * lossless-ish). Range 0 (lossless, huge) — 51 (worst, tiny). Lower
+     * by 2 to roughly halve the bitrate at a given quality. Only consulted
+     * when {@link videoEncoder} is libx264.
+     */
+    crf?: number;
+    /**
+     * Output keyframe interval in seconds. Default 1 — important for
+     * mid-stream join latency (a new HLS / RTSP client only starts
+     * decoding from the next keyframe). Lower = faster join, larger
+     * stream; higher = better compression, slower join.
+     */
+    gopSeconds?: number;
+    /**
+     * Free-form ffmpeg arguments inserted at the START of the argv (after
+     * `-hide_banner -loglevel`). Use for hardware-accel decode hints that
+     * must appear before any `-i`:
+     *
+     *   extraGlobalArgs: ["-hwaccel","videotoolbox"]
+     *   extraGlobalArgs: ["-hwaccel","qsv","-qsv_device","/dev/dri/renderD128"]
+     *
+     * No validation — invalid args here WILL crash ffmpeg.
+     */
+    extraGlobalArgs?: readonly string[];
+    /**
+     * Free-form ffmpeg arguments inserted just BEFORE the `pipe:1` output.
+     * Use for encoder-specific options when {@link videoEncoder} is not
+     * `libx264`:
+     *
+     *   extraOutputArgs: ["-q:v","23"]                  // qsv/vaapi
+     *   extraOutputArgs: ["-preset","fast","-rc","cbr"] // nvenc
+     *
+     * No validation — invalid args here WILL crash ffmpeg.
+     */
+    extraOutputArgs?: readonly string[];
 }
 type CompositeStreamOptions = {
     api: ReolinkBaichuanApi;
@@ -5296,6 +5408,24 @@ type CompositeStreamOptions = {
     teleRtspUrl?: string;
     /** ffmpeg `-rtsp_transport` value (default: tcp). */
     rtspTransport?: 'tcp' | 'udp';
+    /**
+     * Absolute path to the `ffmpeg` binary the compositor should `spawn()`.
+     * Mirrors {@link CompositeStreamPipOptions.ffmpegPath} — see its docstring
+     * for the rationale. Defaults to `"ffmpeg"` (PATH lookup) when unset.
+     */
+    ffmpegPath?: string;
+    /** See {@link CompositeStreamPipOptions.videoEncoder}. */
+    videoEncoder?: string;
+    /** See {@link CompositeStreamPipOptions.encoderPreset}. */
+    encoderPreset?: string;
+    /** See {@link CompositeStreamPipOptions.crf}. */
+    crf?: number;
+    /** See {@link CompositeStreamPipOptions.gopSeconds}. */
+    gopSeconds?: number;
+    /** See {@link CompositeStreamPipOptions.extraGlobalArgs}. */
+    extraGlobalArgs?: readonly string[];
+    /** See {@link CompositeStreamPipOptions.extraOutputArgs}. */
+    extraOutputArgs?: readonly string[];
     /**
      * How long to wait for each input stream to produce frames before starting ffmpeg.
      * Battery cameras can take several seconds to wake and begin streaming.
@@ -11459,6 +11589,16 @@ type AutoDetectInputs = {
      * If omitted, autodetect will try `local-direct`, then `local-broadcast`, then `remote`, then `relay`, then `map`.
      */
     udpDiscoveryMethod?: BaichuanClientOptions["udpDiscoveryMethod"];
+    /**
+     * Hard upper bound on the TCP connect + Baichuan login attempt. The
+     * macOS / Linux TCP stack normally takes 60-160s to return
+     * EHOSTDOWN / EHOSTUNREACH (ARP retry chain). Without a deadline,
+     * autodetect against an unreachable host blocks for that entire
+     * window even though the parallel UDP race already failed. Defaults
+     * to 8s — well above a healthy LAN login (~250ms) and well below
+     * the OS chain. Tune higher only for legitimately slow links.
+     */
+    tcpConnectTimeoutMs?: number;
 };
 type UdpDiscoveryMethod = NonNullable<BaichuanClientOptions["udpDiscoveryMethod"]>;
 /**
@@ -12085,4 +12225,4 @@ interface CreateEmailPushServerParams {
 declare function getCameraEmailAddress(cameraId: string, domain: string): string;
 declare function createEmailPushServer(params: CreateEmailPushServerParams): EmailPushServerInstance;
 
-export { type AIDetectionState, type AIEvent, type AIState, ALL_UDP_DISCOVERY_METHODS, type AbilityInfo, type AccessUserListConfig, AesStreamDecryptor, type AiAlarmConfig, type AiConfig, type AiDenoiseConfig, type AiDetectCfgZone, type AiKey, type AiTypesCacheEntry, type AnyBuffer, type AudioAlarmParams, type AudioCfgConfig, type AudioConfig, type AudioNoiseConfig, type AudioTaskConfig, type AutoDetectInputs, type AutoDetectMode, type AutoDetectResult, type AutoFocusConfig, type AutoRebootConfig, type AutoRebootConfigPatch, 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_AUTO_FOCUS, BC_CMD_ID_GET_AUTO_REBOOT, 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_DST, BC_CMD_ID_GET_EMAIL, BC_CMD_ID_GET_EMAIL_TASK, BC_CMD_ID_GET_ENC, 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_NTP, BC_CMD_ID_GET_ONLINE_USER_LIST, BC_CMD_ID_GET_OSD_DATETIME, BC_CMD_ID_GET_PIR_INFO, BC_CMD_ID_GET_PRIVACY_MASK, BC_CMD_ID_GET_PTZ_POSITION, BC_CMD_ID_GET_PTZ_PRESET, BC_CMD_ID_GET_PUSH_TASK, 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_SNAPSHOT, 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_UID, BC_CMD_ID_GET_VERSION_INFO, 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_AI_DENOISE, BC_CMD_ID_SET_AUDIO_CFG, BC_CMD_ID_SET_AUDIO_TASK, BC_CMD_ID_SET_AUTO_FOCUS, BC_CMD_ID_SET_AUTO_REBOOT, BC_CMD_ID_SET_DAY_NIGHT_THRESHOLD, BC_CMD_ID_SET_DING_DONG_CFG, BC_CMD_ID_SET_DING_DONG_SILENT, BC_CMD_ID_SET_DST, BC_CMD_ID_SET_EMAIL, BC_CMD_ID_SET_EMAIL_TASK, BC_CMD_ID_SET_ENC, BC_CMD_ID_SET_LED_STATE, BC_CMD_ID_SET_MOTION_ALARM, BC_CMD_ID_SET_NTP, BC_CMD_ID_SET_OSD_DATETIME, BC_CMD_ID_SET_PIR_INFO, BC_CMD_ID_SET_PRIVACY_MASK, BC_CMD_ID_SET_PUSH_TASK, BC_CMD_ID_SET_RECORD, BC_CMD_ID_SET_RECORD_CFG, BC_CMD_ID_SET_SYSTEM_GENERAL, BC_CMD_ID_SET_VIDEO_INPUT, 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_TEST_EMAIL, 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 BackchannelCodec, type BackchannelRoute, type BaichuanCachedPush, BaichuanClient, type BaichuanClientOptions, type BaichuanCoordinatePointListPush, type BaichuanDingdongListPush, type BaichuanEndpointsServerOptions, BaichuanEventEmitter, type BaichuanFloodlightStatusPush, 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, BaichuanRtspBackchannelServer, type BaichuanRtspBackchannelServerOptions, BaichuanRtspServer, type BaichuanRtspServerOptions, type BaichuanSerialPush, type BaichuanSettingsPushCacheEntry, type BaichuanSirenStatusPush, type BaichuanSleepState, type BaichuanSleepStatusPush, type BaichuanStreamEncodeTable, type BaichuanStreamInfo, type BaichuanStreamInfoList, type BaichuanTransport, type BaichuanVersionInfo, 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 CgiAiAlarm, type CgiAiCfg, type CgiAiKey, type CgiAiStateValue, type CgiAudioAlarm, type CgiAudioAlarmPlayParam, type CgiAudioCfg, type CgiAudioNoise, type CgiAutoFocus, type CgiBattery, type CgiChannelStatusEntry, type CgiChnTypeInfoValue, type CgiDetectionState, type CgiDevInfo, type CgiDeviceInfoEntries, type CgiEmail, type CgiEnc, type CgiEncStream, type CgiEncValue, type CgiGetAbilityResponse, type CgiGetAbilityValue, type CgiGetAiAlarmValue, type CgiGetAiCfgValue, type CgiGetAiStateResponse, type CgiGetAudioAlarmValue, type CgiGetAudioCfgValue, type CgiGetAudioNoiseValue, type CgiGetAutoFocusValue, type CgiGetChannelstatusResponse, type CgiGetChannelstatusValue, type CgiGetChnTypeInfoResponse, type CgiGetDevInfoResponse, type CgiGetDevInfoValue, type CgiGetEmailValue, type CgiGetEncResponse, type CgiGetImageValue, type CgiGetIrLightsValue, type CgiGetIspValue, type CgiGetMaskValue, type CgiGetMdAlarmValue, type CgiGetOsdValue, type CgiGetPushValue, type CgiGetRecValue, type CgiGetRtspUrlResponse, type CgiGetRtspUrlValue, type CgiGetVideoclipsParams, type CgiImage, type CgiIrLights, type CgiIsp, type CgiMask, type CgiMaskShelter, type CgiMdAlarm, type CgiMdAlarmScope, type CgiMdAlarmSens, type CgiNetPort, type CgiOsd, type CgiPirInfo, type CgiPtzPreset, type CgiPush, type CgiRec, type CgiRecSchedule, type CgiSetAiAlarmParam, type CgiSetAiCfgParam, type CgiSetAudioAlarmParam, type CgiSetAudioCfgParam, type CgiSetAudioNoiseParam, type CgiSetAutoFocusParam, type CgiSetEmailParam, type CgiSetEncParam, type CgiSetImageParam, type CgiSetIrLightsParam, type CgiSetIspParam, type CgiSetMaskParam, type CgiSetMdAlarmParam, type CgiSetOsdParam, type CgiSetPirInfoParam, type CgiSetPushParam, type CgiSetRecParam, 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, type CompressionStream, type CreateEmailPushServerParams, DEFAULT_SHELTER_CANVAS, DUAL_LENS_DUAL_MOTION_MODELS, DUAL_LENS_MODELS, DUAL_LENS_SINGLE_MOTION_MODELS, type DayNightThresholdConfig, type DayOfWeek, 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 DstConfig, type DstConfigPatch, type DualLensChannelAnalysis, type DualLensChannelInfo, type EmailAttachmentType, type EmailConfig, type EmailConfigPatch, type EmailPushEvent, type EmailPushInferredType, type EmailPushLogger, type EmailPushServerConfig, type EmailPushServerInstance, type EmailPushServerStatus, type EmailPushTlsOptions, type EmailTaskConfig, type EmailTaskScheduleItem, type EmailTextType, type EncConfig, type EncOptions, type EncResolutionOption, type EncStreamOptions, type EncStreamPatch, type EncryptionProtocol, type Events, type EventsResponse, type FloodlightTaskConfig, type FloodlightTaskState, 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 IrLightsConfig, type IspConfig, type JsonObject, type JsonPrimitive, type JsonValue, type LastSleepProbe, type LoadTlsParams, type LogLevel, type Logger, type LoggerCallback, type LoginResponseValue, type MaskConfig, type MaxEncryption, type MediaStream, type MjpegFrame, MjpegTransformer, type MjpegTransformerOptions, type ModelFixtureCaptureResult, type MotionAlarmConfig, type MotionEvent, type MotionSensitivityBand, type MotionZoneScope, MpegTsMuxer, type MpegTsMuxerOptions, NVR_HUB_EXACT_TYPES, NVR_HUB_MODEL_PATTERNS, type NativeVideoStreamVariant, type NtpConfig, type NtpConfigPatch, type NvrChannelsSummaryCacheEntry, type OnlineUserListConfig, type OsdChannel, type OsdConfig, type OsdDateFormat, type OsdTime, type ParsedRecordingFileName, type PipPosition, type PirConfig, type PirState, type PlaybackSnapshotStreamInfo, type PrivacyMaskZones, 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 ReolinkDetectionBox, type ReolinkDetectionDecodeState, type ReolinkDetectionEvent, 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, RtspBackchannel, type RtspBackchannelOptions, type RtspCreateOptions, type RtspProxyServerOptions, type RtspStreamProfile, type RunAllDiagnosticsConsecutivelyParams, type RunAllDiagnosticsConsecutivelyResult, type RunMultifocalDiagnosticsConsecutivelyParams, type RunMultifocalDiagnosticsConsecutivelyResult, type ShelterCanvas, type ShelterRect, type SirenState, type SirenStatusConfig, type SleepInferenceDecision, type SleepInferenceInput, type SleepInferencePending, type SleepState, type SleepStatus, type StreamMetadata, type StreamProfile, type StreamSamplingOptions, type StreamSamplingSelection, type SupportConfig, type SupportInfo, type SupportItem, type SystemGeneralConfig, type SystemGeneralPatch, type TalkAbility$1 as TalkAbility, type TalkAudioConfig, type TalkConfig, type TalkSession$1 as TalkSession, type TalkSessionInfo, type TimeFormat, type TimelapseCfgConfig, type TrackShelterRect, type TwoWayAudioConfig, type UdpDiscoveryMethod, type UnknownChunkListener, 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 XmlJsonObject, type XmlJsonPrimitive, type XmlJsonValue, type ZoomFocusStatus, type ZoomFocusTriplet, _resetEmailPushBusForTests, abilitiesHasAny, aesDecrypt, aesEncrypt, alawToPcm16, applyStreamPatch, applyXmlTagPatch, 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, computeExpectedStreamCompatibility, convertToAnnexB as convertH265ToAnnexB, convertToAnnexB$1 as convertToAnnexB, convertToLengthPrefixed, createBaichuanEndpointsServer, createDebugGateLogger, createDiagnosticsBundle, createEmailPushServer, createLogger, createMjpegBoundary, createNativeStream, createNullLogger, createReplayHttpServer, createRfc4571TcpServer, createRfc4571TcpServerForReplay, createRtspProxyServer, createTaggedLogger, decideSleepInferenceTransition, decideVideoclipTranscodeMode, decodeAiDetectCfg, decodeHeader, decodeMotionScopeBitmap, decodePrivacyMaskZones, decodeShelterCoord, deriveAesKey, detectIosClient, detectVideoCodecFromNal, discoverReolinkDevices, discoverViaArpTable, discoverViaDhcpListener, discoverViaHttpScan, discoverViaOnvif, discoverViaTcpPortScan, discoverViaUdpBroadcast, discoverViaUdpDirect, emitEmailPushEvent, encodeHeader, encodeImaAdpcm, encodeMotionScopeBitmap, encodeMotionSensitivityListXml, encodeShelterCoord, encodeShelterListXml, encodeTrackShelterListXml, ensureXmlHeader, extractCanvasFromShelterXml, extractH264ParamSetsFromAccessUnit, extractH265ParamSetsFromAccessUnit, extractPpsFromAnnexB, extractSpsFromAnnexB, extractVpsFromAnnexB, flattenAbilitiesForChannel, formatMjpegFrame, fullCoverageScope, getCameraEmailAddress, getConstructedVideoStreamOptions, getEmailPushCameraResolver, getGlobalLogger, getH265NalType, getLastEmailPushEvent, getMjpegContentType, getRecentEmailPushEvents, getSupportItemForChannel, getVideoStream, getVideoclipClientInfo, getXmlText, hasStartCodes as hasH265StartCodes, hasStartCodes$1 as hasStartCodes, isDualLenseModel, isH264KeyframeAnnexB, isH265Irap, isH265KeyframeAnnexB, isNvrHubModel, isTcpFailureThatShouldFallbackToUdp, isUnroutableForP2P, isValidH264AnnexBAccessUnit, isValidH265AnnexBAccessUnit, loadEmailPushTls, mapEmailPushInferredType, maskUid, md5HexUpper, md5StrModern, mulawToPcm16, normalizeDayNightMode, normalizeOpenClose, normalizeUid, onEmailPushEvent, packetizeAacAdtsFrame, packetizeAacRawFrame, packetizeH264, packetizeH265, parseAdtsHeader, parseBcMedia, parseRecordingFileName, parseRtpPacket, parseSupportXml, patchAiDetectCfgXml, patchMotionSensitivityListXml, patchNestedTag, patchShelterXml, printNvrDiagnostics, runAllDiagnosticsConsecutively, runMultifocalDiagnosticsConsecutively, sampleStreams, sanitizeFixtureData, selectViableUdpMethods, setEmailPushCameraResolver, setGlobalLogger, splitAnnexBToNalPayloads$1 as splitAnnexBToNalPayloads, splitAnnexBToNals, splitAnnexBToNalPayloads as splitH265AnnexBToNalPayloads, tcpReachabilityProbe, testChannelStreams, upsamplePcm16, upsertXmlTag, xmlEscape, xmlIndicatesFloodlight, zipDirectory };
+export { type AIDetectionState, type AIEvent, type AIState, ALL_UDP_DISCOVERY_METHODS, type AbilityInfo, type AccessUserListConfig, AesStreamDecryptor, type AiAlarmConfig, type AiConfig, type AiDenoiseConfig, type AiDetectCfgZone, type AiKey, type AiTypesCacheEntry, type AnyBuffer, type AudioAlarmParams, type AudioCfgConfig, type AudioConfig, type AudioNoiseConfig, type AudioTaskConfig, type AutoDetectInputs, type AutoDetectMode, type AutoDetectResult, type AutoFocusConfig, type AutoRebootConfig, type AutoRebootConfigPatch, 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_DEVICE_DETECT, BC_CMD_ID_DEVICE_DETECT_CANDIDATES, 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_AUTO_FOCUS, BC_CMD_ID_GET_AUTO_REBOOT, 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_DST, BC_CMD_ID_GET_EMAIL, BC_CMD_ID_GET_EMAIL_TASK, BC_CMD_ID_GET_ENC, 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_NTP, BC_CMD_ID_GET_ONLINE_USER_LIST, BC_CMD_ID_GET_OSD_DATETIME, BC_CMD_ID_GET_PIR_INFO, BC_CMD_ID_GET_PRIVACY_MASK, BC_CMD_ID_GET_PTZ_POSITION, BC_CMD_ID_GET_PTZ_PRESET, BC_CMD_ID_GET_PUSH_TASK, 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_SNAPSHOT, 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_UID, BC_CMD_ID_GET_VERSION_INFO, 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_AI_DENOISE, BC_CMD_ID_SET_AUDIO_CFG, BC_CMD_ID_SET_AUDIO_TASK, BC_CMD_ID_SET_AUTO_FOCUS, BC_CMD_ID_SET_AUTO_REBOOT, BC_CMD_ID_SET_DAY_NIGHT_THRESHOLD, BC_CMD_ID_SET_DING_DONG_CFG, BC_CMD_ID_SET_DING_DONG_SILENT, BC_CMD_ID_SET_DST, BC_CMD_ID_SET_EMAIL, BC_CMD_ID_SET_EMAIL_TASK, BC_CMD_ID_SET_ENC, BC_CMD_ID_SET_LED_STATE, BC_CMD_ID_SET_MOTION_ALARM, BC_CMD_ID_SET_NTP, BC_CMD_ID_SET_OSD_DATETIME, BC_CMD_ID_SET_PIR_INFO, BC_CMD_ID_SET_PRIVACY_MASK, BC_CMD_ID_SET_PUSH_TASK, BC_CMD_ID_SET_RECORD, BC_CMD_ID_SET_RECORD_CFG, BC_CMD_ID_SET_SYSTEM_GENERAL, BC_CMD_ID_SET_VIDEO_INPUT, 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_TEST_EMAIL, 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 BackchannelCodec, type BackchannelRoute, type BaichuanCachedPush, BaichuanClient, type BaichuanClientOptions, type BaichuanCoordinatePointListPush, type BaichuanDingdongListPush, type BaichuanEndpointsServerOptions, BaichuanEventEmitter, type BaichuanFloodlightStatusPush, 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, BaichuanRtspBackchannelServer, type BaichuanRtspBackchannelServerOptions, BaichuanRtspServer, type BaichuanRtspServerOptions, type BaichuanSerialPush, type BaichuanSettingsPushCacheEntry, type BaichuanSirenStatusPush, type BaichuanSleepState, type BaichuanSleepStatusPush, type BaichuanStreamEncodeTable, type BaichuanStreamInfo, type BaichuanStreamInfoList, type BaichuanTransport, type BaichuanVersionInfo, 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 CgiAiAlarm, type CgiAiCfg, type CgiAiKey, type CgiAiStateValue, type CgiAudioAlarm, type CgiAudioAlarmPlayParam, type CgiAudioCfg, type CgiAudioNoise, type CgiAutoFocus, type CgiBattery, type CgiChannelStatusEntry, type CgiChnTypeInfoValue, type CgiDetectionState, type CgiDevInfo, type CgiDeviceInfoEntries, type CgiEmail, type CgiEnc, type CgiEncStream, type CgiEncValue, type CgiGetAbilityResponse, type CgiGetAbilityValue, type CgiGetAiAlarmValue, type CgiGetAiCfgValue, type CgiGetAiStateResponse, type CgiGetAudioAlarmValue, type CgiGetAudioCfgValue, type CgiGetAudioNoiseValue, type CgiGetAutoFocusValue, type CgiGetChannelstatusResponse, type CgiGetChannelstatusValue, type CgiGetChnTypeInfoResponse, type CgiGetDevInfoResponse, type CgiGetDevInfoValue, type CgiGetEmailValue, type CgiGetEncResponse, type CgiGetImageValue, type CgiGetIrLightsValue, type CgiGetIspValue, type CgiGetMaskValue, type CgiGetMdAlarmValue, type CgiGetOsdValue, type CgiGetPushValue, type CgiGetRecValue, type CgiGetRtspUrlResponse, type CgiGetRtspUrlValue, type CgiGetVideoclipsParams, type CgiImage, type CgiIrLights, type CgiIsp, type CgiMask, type CgiMaskShelter, type CgiMdAlarm, type CgiMdAlarmScope, type CgiMdAlarmSens, type CgiNetPort, type CgiOsd, type CgiPirInfo, type CgiPtzPreset, type CgiPush, type CgiRec, type CgiRecSchedule, type CgiSetAiAlarmParam, type CgiSetAiCfgParam, type CgiSetAudioAlarmParam, type CgiSetAudioCfgParam, type CgiSetAudioNoiseParam, type CgiSetAutoFocusParam, type CgiSetEmailParam, type CgiSetEncParam, type CgiSetImageParam, type CgiSetIrLightsParam, type CgiSetIspParam, type CgiSetMaskParam, type CgiSetMdAlarmParam, type CgiSetOsdParam, type CgiSetPirInfoParam, type CgiSetPushParam, type CgiSetRecParam, 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, type CompressionStream, type CreateEmailPushServerParams, DEFAULT_SHELTER_CANVAS, DUAL_LENS_DUAL_MOTION_MODELS, DUAL_LENS_MODELS, DUAL_LENS_SINGLE_MOTION_MODELS, type DayNightThresholdConfig, type DayOfWeek, 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 DstConfig, type DstConfigPatch, type DualLensChannelAnalysis, type DualLensChannelInfo, type EmailAttachmentType, type EmailConfig, type EmailConfigPatch, type EmailPushEvent, type EmailPushInferredType, type EmailPushLogger, type EmailPushServerConfig, type EmailPushServerInstance, type EmailPushServerStatus, type EmailPushTlsOptions, type EmailTaskConfig, type EmailTaskScheduleItem, type EmailTextType, type EncConfig, type EncOptions, type EncResolutionOption, type EncStreamOptions, type EncStreamPatch, type EncryptionProtocol, type Events, type EventsResponse, type FloodlightTaskConfig, type FloodlightTaskState, 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 IrLightsConfig, type IspConfig, type JsonObject, type JsonPrimitive, type JsonValue, type LastSleepProbe, type LoadTlsParams, type LogLevel, type Logger, type LoggerCallback, type LoginResponseValue, type MaskConfig, type MaxEncryption, type MediaStream, type MjpegFrame, MjpegTransformer, type MjpegTransformerOptions, type ModelFixtureCaptureResult, type MotionAlarmConfig, type MotionEvent, type MotionSensitivityBand, type MotionZoneScope, MpegTsMuxer, type MpegTsMuxerOptions, NVR_HUB_EXACT_TYPES, NVR_HUB_MODEL_PATTERNS, type NativeVideoStreamVariant, type NtpConfig, type NtpConfigPatch, type NvrChannelsSummaryCacheEntry, type OnlineUserListConfig, type OsdChannel, type OsdConfig, type OsdDateFormat, type OsdTime, type ParsedRecordingFileName, type PipPosition, type PirConfig, type PirState, type PlaybackSnapshotStreamInfo, type PrivacyMaskZones, 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 ReolinkDetectionBox, type ReolinkDetectionDecodeState, type ReolinkDetectionEvent, 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, RtspBackchannel, type RtspBackchannelOptions, type RtspCreateOptions, type RtspProxyServerOptions, type RtspStreamProfile, type RunAllDiagnosticsConsecutivelyParams, type RunAllDiagnosticsConsecutivelyResult, type RunMultifocalDiagnosticsConsecutivelyParams, type RunMultifocalDiagnosticsConsecutivelyResult, type ShelterCanvas, type ShelterRect, type SirenState, type SirenStatusConfig, type SleepInferenceDecision, type SleepInferenceInput, type SleepInferencePending, type SleepState, type SleepStatus, type StreamMetadata, type StreamProfile, type StreamSamplingOptions, type StreamSamplingSelection, type SupportConfig, type SupportInfo, type SupportItem, type SystemGeneralConfig, type SystemGeneralPatch, type TalkAbility$1 as TalkAbility, type TalkAudioConfig, type TalkConfig, type TalkSession$1 as TalkSession, type TalkSessionInfo, type TimeFormat, type TimelapseCfgConfig, type TrackShelterRect, type TwoWayAudioConfig, type UdpDiscoveryMethod, type UnknownChunkListener, 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 XmlJsonObject, type XmlJsonPrimitive, type XmlJsonValue, type ZoomFocusStatus, type ZoomFocusTriplet, _resetEmailPushBusForTests, abilitiesHasAny, aesDecrypt, aesEncrypt, alawToPcm16, applyStreamPatch, applyXmlTagPatch, 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, computeExpectedStreamCompatibility, convertToAnnexB as convertH265ToAnnexB, convertToAnnexB$1 as convertToAnnexB, convertToLengthPrefixed, createBaichuanEndpointsServer, createDebugGateLogger, createDiagnosticsBundle, createEmailPushServer, createLogger, createMjpegBoundary, createNativeStream, createNullLogger, createReplayHttpServer, createRfc4571TcpServer, createRfc4571TcpServerForReplay, createRtspProxyServer, createTaggedLogger, decideSleepInferenceTransition, decideVideoclipTranscodeMode, decodeAiDetectCfg, decodeHeader, decodeMotionScopeBitmap, decodePrivacyMaskZones, decodeShelterCoord, deriveAesKey, detectIosClient, detectVideoCodecFromNal, discoverReolinkDevices, discoverViaArpTable, discoverViaDhcpListener, discoverViaHttpScan, discoverViaOnvif, discoverViaTcpPortScan, discoverViaUdpBroadcast, discoverViaUdpDirect, emitEmailPushEvent, encodeHeader, encodeImaAdpcm, encodeMotionScopeBitmap, encodeMotionSensitivityListXml, encodeShelterCoord, encodeShelterListXml, encodeTrackShelterListXml, ensureXmlHeader, extractCanvasFromShelterXml, extractH264ParamSetsFromAccessUnit, extractH265ParamSetsFromAccessUnit, extractPpsFromAnnexB, extractSpsFromAnnexB, extractVpsFromAnnexB, flattenAbilitiesForChannel, formatMjpegFrame, fullCoverageScope, getCameraEmailAddress, getConstructedVideoStreamOptions, getEmailPushCameraResolver, getGlobalLogger, getH265NalType, getLastEmailPushEvent, getMjpegContentType, getRecentEmailPushEvents, getSupportItemForChannel, getVideoStream, getVideoclipClientInfo, getXmlText, hasStartCodes as hasH265StartCodes, hasStartCodes$1 as hasStartCodes, isDualLenseModel, isH264KeyframeAnnexB, isH265Irap, isH265KeyframeAnnexB, isNvrHubModel, isTcpFailureThatShouldFallbackToUdp, isUnroutableForP2P, isValidH264AnnexBAccessUnit, isValidH265AnnexBAccessUnit, loadEmailPushTls, mapEmailPushInferredType, maskUid, md5HexUpper, md5StrModern, mulawToPcm16, normalizeDayNightMode, normalizeOpenClose, normalizeUid, onEmailPushEvent, packetizeAacAdtsFrame, packetizeAacRawFrame, packetizeH264, packetizeH265, parseAdtsHeader, parseBcMedia, parseRecordingFileName, parseRtpPacket, parseSupportXml, patchAiDetectCfgXml, patchMotionSensitivityListXml, patchNestedTag, patchShelterXml, printNvrDiagnostics, runAllDiagnosticsConsecutively, runMultifocalDiagnosticsConsecutively, sampleStreams, sanitizeFixtureData, selectViableUdpMethods, setEmailPushCameraResolver, setGlobalLogger, splitAnnexBToNalPayloads$1 as splitAnnexBToNalPayloads, splitAnnexBToNals, splitAnnexBToNalPayloads as splitH265AnnexBToNalPayloads, tcpReachabilityProbe, testChannelStreams, upsamplePcm16, upsertXmlTag, xmlEscape, xmlIndicatesFloodlight, zipDirectory };

package/dist/index.d.ts

@@ -373,6 +373,16 @@ export declare type AutoDetectInputs = {
      * If omitted, autodetect will try `local-direct`, then `local-broadcast`, then `remote`, then `relay`, then `map`.
      */
     udpDiscoveryMethod?: BaichuanClientOptions["udpDiscoveryMethod"];
+    /**
+     * Hard upper bound on the TCP connect + Baichuan login attempt. The
+     * macOS / Linux TCP stack normally takes 60-160s to return
+     * EHOSTDOWN / EHOSTUNREACH (ARP retry chain). Without a deadline,
+     * autodetect against an unreachable host blocks for that entire
+     * window even though the parallel UDP race already failed. Defaults
+     * to 8s — well above a healthy LAN login (~250ms) and well below
+     * the OS chain. Tune higher only for legitimately slow links.
+     */
+    tcpConnectTimeoutMs?: number;
 };
 
 export declare type AutoDetectMode = "auto" | BaichuanTransport;
@@ -2436,6 +2446,10 @@ export declare const BC_CMD_ID_COVER_STANDALONE_461 = 461;
 
 export declare const BC_CMD_ID_COVER_STANDALONE_462 = 462;
 
+export declare const BC_CMD_ID_DEVICE_DETECT: number | null;
+
+export declare const BC_CMD_ID_DEVICE_DETECT_CANDIDATES: readonly [31, 132, 150];
+
 export declare const BC_CMD_ID_DING_DONG_CTRL = 483;
 
 export declare const BC_CMD_ID_DING_DONG_OPT = 485;
@@ -2910,6 +2924,16 @@ export declare class BcUdpStream extends EventEmitter<{
     debug: [string, unknown?];
 }> {
     private readonly opts;
+    /**
+     * Optional info-level logger for diagnostic milestones — set via
+     * {@link BcUdpStream.setLogger} by `BaichuanClient` so the lib's
+     * standard logger sink sees BCUDP / P2P progress (DNS resolutions,
+     * outgoing UDP probes, timeouts with elapsed times) without the user
+     * having to opt into the per-packet `debug` event firehose. Kept
+     * separate from `emit('debug', ...)` because that channel is intended
+     * for the per-packet debug trace and is gated by debugOptions.
+     */
+    private discoveryLogger;
     private sock;
     private remote?;
     private mtu;
@@ -2937,6 +2961,15 @@ export declare class BcUdpStream extends EventEmitter<{
     private getKeepAliveTid;
     constructor(options: BcUdpStreamOptions);
     /** True if the underlying UDP socket is open and the remote peer is known. */
+    /**
+     * Attach an info-level logger for high-signal diagnostic milestones
+     * (DNS resolution, outgoing UDP probe sends, P2P UID lookup wins/losses,
+     * BCUDP local discovery timeouts). The lib's `BaichuanClient` calls
+     * this immediately after constructing the stream so consumers get
+     * actionable progress logs without enabling the per-packet debug trace.
+     * Safe to call repeatedly; only the most recent logger is used.
+     */
+    setLogger(logger: Logger | undefined): void;
     isConnected(): boolean;
     connect(): Promise<void>;
     private discoveryUid;
@@ -2988,6 +3021,15 @@ export declare type BcUdpStreamOptions = {
      * - `relay`: fully relayed via Reolink servers
      */
     discoveryMethod?: BcUdpDiscoveryMethod;
+    /**
+     * Override the default 15s timeout on local-direct / local-broadcast
+     * BCUDP discovery (the time we'll wait for a camera reply after
+     * sending C2D_S probes). Battery cams that are awake reply in
+     * 1-5s — keeping the default short collapses the user-visible
+     * failure path for off-LAN / sleeping cameras. Raise this only
+     * for pathologically slow LANs where 15s is genuinely not enough.
+     */
+    localDiscoveryTimeoutMs?: number;
 } | {
     /** Direct connection with already-known parameters. */
     mode: "direct";
@@ -4103,6 +4145,24 @@ export declare type CompositeStreamOptions = {
     teleRtspUrl?: string;
     /** ffmpeg `-rtsp_transport` value (default: tcp). */
     rtspTransport?: 'tcp' | 'udp';
+    /**
+     * Absolute path to the `ffmpeg` binary the compositor should `spawn()`.
+     * Mirrors {@link CompositeStreamPipOptions.ffmpegPath} — see its docstring
+     * for the rationale. Defaults to `"ffmpeg"` (PATH lookup) when unset.
+     */
+    ffmpegPath?: string;
+    /** See {@link CompositeStreamPipOptions.videoEncoder}. */
+    videoEncoder?: string;
+    /** See {@link CompositeStreamPipOptions.encoderPreset}. */
+    encoderPreset?: string;
+    /** See {@link CompositeStreamPipOptions.crf}. */
+    crf?: number;
+    /** See {@link CompositeStreamPipOptions.gopSeconds}. */
+    gopSeconds?: number;
+    /** See {@link CompositeStreamPipOptions.extraGlobalArgs}. */
+    extraGlobalArgs?: readonly string[];
+    /** See {@link CompositeStreamPipOptions.extraOutputArgs}. */
+    extraOutputArgs?: readonly string[];
     /**
      * How long to wait for each input stream to produce frames before starting ffmpeg.
      * Battery cameras can take several seconds to wake and begin streaming.
@@ -4150,6 +4210,88 @@ export declare interface CompositeStreamPipOptions {
     teleRtspUrl?: string;
     /** ffmpeg `-rtsp_transport` value (default: tcp). */
     rtspTransport?: 'tcp' | 'udp';
+    /**
+     * Absolute path to the `ffmpeg` binary the compositor should `spawn()`.
+     *
+     * When unset, falls back to the bare string `"ffmpeg"`, which relies on
+     * the host's `PATH`. This works on standard Linux / macOS Node setups
+     * but fails silently on environments where the embedding process
+     * strips PATH or ships its own ffmpeg in a non-discoverable location:
+     *
+     *  - Scrypted on Windows (the Electron host launches plugins with a
+     *    minimal PATH; the bundled ffmpeg lives at a static absolute path
+     *    only `sdk.mediaManager.getFFmpegPath()` knows about).
+     *  - Scrypted on macOS App Store / sandboxed installs.
+     *  - Distroless / minimal Docker base images where ffmpeg is mounted
+     *    at a fixed path but not in PATH.
+     *
+     * Consumers in any of those environments should resolve the path
+     * themselves (e.g. via the Scrypted SDK) and pass it through here.
+     */
+    ffmpegPath?: string;
+    /**
+     * Output video encoder name (passed verbatim as `-c:v`). Default
+     * `libx264` — pure software. On a host with hardware-accelerated
+     * H.264 encoding, switching this is the single biggest perf win
+     * available (5-10x less CPU for the same output bitrate). Supported
+     * by ffmpeg in the wild:
+     *
+     *  - Intel/AMD QuickSync:  `h264_qsv`
+     *  - Intel/AMD VAAPI:      `h264_vaapi`
+     *  - NVIDIA NVENC:         `h264_nvenc`
+     *  - Apple VideoToolbox:   `h264_videotoolbox`
+     *  - Raspberry Pi / ARM:   `h264_v4l2m2m`
+     *
+     * Caveat: when not `libx264`, the libx264-specific knobs
+     * (`encoderPreset`, `crf`, `x264-params`) are silently dropped because
+     * each HW encoder has its own option vocabulary. Use
+     * {@link extraOutputArgs} to pass encoder-specific options
+     * (e.g. `["-q:v","23"]` for QSV, `["-preset","fast"]` for NVENC).
+     */
+    videoEncoder?: string;
+    /**
+     * libx264 preset (default `ultrafast`). Only consulted when
+     * {@link videoEncoder} is left at its default (libx264). Valid:
+     * `ultrafast | superfast | veryfast | faster | fast | medium | slow |
+     * slower | veryslow | placebo`. Slower = better compression / more CPU.
+     */
+    encoderPreset?: string;
+    /**
+     * CRF (constant rate factor) for libx264. Default 23 (visually
+     * lossless-ish). Range 0 (lossless, huge) — 51 (worst, tiny). Lower
+     * by 2 to roughly halve the bitrate at a given quality. Only consulted
+     * when {@link videoEncoder} is libx264.
+     */
+    crf?: number;
+    /**
+     * Output keyframe interval in seconds. Default 1 — important for
+     * mid-stream join latency (a new HLS / RTSP client only starts
+     * decoding from the next keyframe). Lower = faster join, larger
+     * stream; higher = better compression, slower join.
+     */
+    gopSeconds?: number;
+    /**
+     * Free-form ffmpeg arguments inserted at the START of the argv (after
+     * `-hide_banner -loglevel`). Use for hardware-accel decode hints that
+     * must appear before any `-i`:
+     *
+     *   extraGlobalArgs: ["-hwaccel","videotoolbox"]
+     *   extraGlobalArgs: ["-hwaccel","qsv","-qsv_device","/dev/dri/renderD128"]
+     *
+     * No validation — invalid args here WILL crash ffmpeg.
+     */
+    extraGlobalArgs?: readonly string[];
+    /**
+     * Free-form ffmpeg arguments inserted just BEFORE the `pipe:1` output.
+     * Use for encoder-specific options when {@link videoEncoder} is not
+     * `libx264`:
+     *
+     *   extraOutputArgs: ["-q:v","23"]                  // qsv/vaapi
+     *   extraOutputArgs: ["-preset","fast","-rc","cbr"] // nvenc
+     *
+     * No validation — invalid args here WILL crash ffmpeg.
+     */
+    extraOutputArgs?: readonly string[];
 }
 
 /**

package/dist/index.js

@@ -69,7 +69,7 @@ import {
   setGlobalLogger,
   tcpReachabilityProbe,
   xmlIndicatesFloodlight
-} from "./chunk-OJQLZETO.js";
+} from "./chunk-7HSTETZR.js";
 import {
   ReolinkCgiApi,
   ReolinkHttpClient,
@@ -116,7 +116,7 @@ import {
   upsertXmlTag,
   xmlEscape,
   zipDirectory
-} from "./chunk-VOPEOB4H.js";
+} from "./chunk-XDVBNZGR.js";
 import {
   AesStreamDecryptor,
   BC_AES_IV,
@@ -140,6 +140,8 @@ import {
   BC_CMD_ID_COVER_STANDALONE_460,
   BC_CMD_ID_COVER_STANDALONE_461,
   BC_CMD_ID_COVER_STANDALONE_462,
+  BC_CMD_ID_DEVICE_DETECT,
+  BC_CMD_ID_DEVICE_DETECT_CANDIDATES,
   BC_CMD_ID_DING_DONG_CTRL,
   BC_CMD_ID_DING_DONG_OPT,
   BC_CMD_ID_FILE_INFO_LIST_CLOSE,
@@ -288,7 +290,7 @@ import {
   parseBcMedia,
   splitAnnexBToNalPayloads,
   splitAnnexBToNalPayloads2
-} from "./chunk-GVWJGQPT.js";
+} from "./chunk-MZUSWKF3.js";
 
 // src/reolink/baichuan/HlsSessionManager.ts
 var withTimeout = async (p, ms, label) => {
@@ -2515,10 +2517,18 @@ var CompositeStream = class extends EventEmitter {
     }
   }
   async startFfmpegCompositionFromRtspUrls(mainWidth, mainHeight, pipWidth, pipHeight, position, widerRtspUrl, teleRtspUrl, rtspTransport) {
+    const videoEncoder = this.options.videoEncoder ?? "libx264";
+    const isX264 = videoEncoder === "libx264";
+    const encoderPreset = this.options.encoderPreset ?? "ultrafast";
+    const crf = this.options.crf ?? 23;
+    const gopSeconds = this.options.gopSeconds ?? 1;
+    const assumedFps = 30;
+    const gopFrames = Math.max(1, Math.round(gopSeconds * assumedFps));
     const ffmpegArgs = [
       "-hide_banner",
       "-loglevel",
       "error",
+      ...this.options.extraGlobalArgs ?? [],
       "-fflags",
       "+genpts",
       // Input 0: wider
@@ -2539,27 +2549,33 @@ var CompositeStream = class extends EventEmitter {
       // Output: always H.264 Annex-B
       "-an",
       "-c:v",
-      "libx264",
+      videoEncoder,
       "-g",
-      "30",
+      String(gopFrames),
       "-keyint_min",
-      "30",
+      String(gopFrames),
       "-sc_threshold",
       "0",
-      "-x264-params",
-      "aud=1:repeat-headers=1:keyint=30:min-keyint=30:scenecut=0",
-      "-preset",
-      "ultrafast",
-      "-tune",
-      "zerolatency",
-      "-crf",
-      "23",
+      ...isX264 ? [
+        "-x264-params",
+        `aud=1:repeat-headers=1:keyint=${gopFrames}:min-keyint=${gopFrames}:scenecut=0`,
+        "-preset",
+        encoderPreset,
+        "-tune",
+        "zerolatency",
+        "-crf",
+        String(crf)
+      ] : [],
+      ...this.options.extraOutputArgs ?? [],
       "-f",
       "h264",
       "pipe:1"
     ];
-    this.logger.log?.(`[CompositeStream] Starting ffmpeg (rtsp inputs): ${ffmpegArgs.join(" ")}`);
-    this.ffmpegProcess = spawn3("ffmpeg", ffmpegArgs, {
+    const ffmpegBin = this.options.ffmpegPath ?? "ffmpeg";
+    this.logger.log?.(
+      `[CompositeStream] Starting ffmpeg (rtsp inputs): bin=${ffmpegBin} args=${ffmpegArgs.join(" ")}`
+    );
+    this.ffmpegProcess = spawn3(ffmpegBin, ffmpegArgs, {
       stdio: ["ignore", "pipe", "pipe"]
     });
     this.ffmpegProcess.on("error", (error) => {
@@ -2626,10 +2642,18 @@ var CompositeStream = class extends EventEmitter {
       "-i",
       "pipe:3"
     ];
+    const videoEncoder = this.options.videoEncoder ?? "libx264";
+    const isX264 = videoEncoder === "libx264";
+    const encoderPreset = this.options.encoderPreset ?? "ultrafast";
+    const crf = this.options.crf ?? 23;
+    const gopSeconds = this.options.gopSeconds ?? 1;
+    const assumedFps = 30;
+    const gopFrames = Math.max(1, Math.round(gopSeconds * assumedFps));
     const ffmpegArgs = [
       "-hide_banner",
       "-loglevel",
       "error",
+      ...this.options.extraGlobalArgs ?? [],
       "-fflags",
       "+genpts",
       "-probesize",
@@ -2648,33 +2672,40 @@ var CompositeStream = class extends EventEmitter {
       "-map",
       "[out]",
       "-c:v",
-      "libx264",
-      // Re-encode for compatibility
-      // Make the stream easy to join mid-flight: frequent IDRs + in-band headers + AUD.
-      // Without this, a new client may wait many seconds for the next keyframe.
+      videoEncoder,
+      // Make the stream easy to join mid-flight: frequent IDRs + in-band
+      // headers + AUD. Without this, a new client may wait many seconds
+      // for the next keyframe.
       "-g",
-      "30",
+      String(gopFrames),
       "-keyint_min",
-      "30",
+      String(gopFrames),
       "-sc_threshold",
       "0",
-      "-x264-params",
-      "aud=1:repeat-headers=1:keyint=30:min-keyint=30:scenecut=0",
-      "-preset",
-      "ultrafast",
-      "-tune",
-      "zerolatency",
-      "-crf",
-      "23",
+      // libx264-specific knobs. We deliberately skip these for HW encoders
+      // — each one has its own option vocabulary (`-q:v`, `-rc`, etc.)
+      // and the user is expected to express them via extraOutputArgs.
+      ...isX264 ? [
+        "-x264-params",
+        `aud=1:repeat-headers=1:keyint=${gopFrames}:min-keyint=${gopFrames}:scenecut=0`,
+        "-preset",
+        encoderPreset,
+        "-tune",
+        "zerolatency",
+        "-crf",
+        String(crf)
+      ] : [],
+      ...this.options.extraOutputArgs ?? [],
       "-f",
       "h264",
       "pipe:1"
       // Output (stdout)
     ];
+    const ffmpegBin = this.options.ffmpegPath ?? "ffmpeg";
     this.logger.log?.(
-      `[CompositeStream] Starting ffmpeg: ${ffmpegArgs.join(" ")}`
+      `[CompositeStream] Starting ffmpeg: bin=${ffmpegBin} args=${ffmpegArgs.join(" ")}`
     );
-    this.ffmpegProcess = spawn3("ffmpeg", ffmpegArgs, {
+    this.ffmpegProcess = spawn3(ffmpegBin, ffmpegArgs, {
       stdio: ["pipe", "pipe", "pipe", "pipe"]
     });
     this.ffmpegProcess.on("error", (error) => {
@@ -3382,6 +3413,20 @@ async function createRfc4571TcpServerInternal(options) {
       ...forceH264 !== void 0 ? { forceH264 } : defaultForceH264 ? { forceH264: true } : {},
       ...compositeOptions?.assumeH264Inputs !== void 0 ? { assumeH264Inputs: compositeOptions.assumeH264Inputs } : {},
       ...compositeOptions?.disableTranscode !== void 0 ? { disableTranscode: compositeOptions.disableTranscode } : {},
+      // Propagate ffmpeg binary path — required when the embedder strips
+      // PATH (Scrypted on Windows, Electron sandboxes, distroless Docker)
+      // and the bundled ffmpeg is at a fixed absolute path only the
+      // embedder knows.
+      ...compositeOptions?.ffmpegPath ? { ffmpegPath: compositeOptions.ffmpegPath } : {},
+      // Encoder tuning knobs — see CompositeStreamPipOptions for the
+      // semantic contract on each one. Plumbed verbatim so the
+      // CompositeStream layer can apply defaults.
+      ...compositeOptions?.videoEncoder ? { videoEncoder: compositeOptions.videoEncoder } : {},
+      ...compositeOptions?.encoderPreset ? { encoderPreset: compositeOptions.encoderPreset } : {},
+      ...typeof compositeOptions?.crf === "number" ? { crf: compositeOptions.crf } : {},
+      ...typeof compositeOptions?.gopSeconds === "number" ? { gopSeconds: compositeOptions.gopSeconds } : {},
+      ...compositeOptions?.extraGlobalArgs ? { extraGlobalArgs: compositeOptions.extraGlobalArgs } : {},
+      ...compositeOptions?.extraOutputArgs ? { extraOutputArgs: compositeOptions.extraOutputArgs } : {},
       logger
     });
     isCompositeStream = true;
@@ -9829,6 +9874,8 @@ export {
   BC_CMD_ID_COVER_STANDALONE_460,
   BC_CMD_ID_COVER_STANDALONE_461,
   BC_CMD_ID_COVER_STANDALONE_462,
+  BC_CMD_ID_DEVICE_DETECT,
+  BC_CMD_ID_DEVICE_DETECT_CANDIDATES,
   BC_CMD_ID_DING_DONG_CTRL,
   BC_CMD_ID_DING_DONG_OPT,
   BC_CMD_ID_FILE_INFO_LIST_CLOSE,