@camstack/addon-provider-reolink 1.2.138 → 1.2.140

package/dist/addon.mjs

@@ -1,5 +1,5 @@
 import { a as __toCommonJS, i as __require, n as __esmMin, o as __toESM, r as __exportAll, t as __commonJSMin } from "./chunk-CNf5ZN-e.mjs";
-import { A as splitAnnexBToNalPayloads2, C as extractVpsFromAnnexB, D as normalizeDebugOptions, E as md5StrModern, M as traceLog, O as recordingsTraceLog, S as extractSpsFromAnnexB, T as isH265Irap, _ as convertToAnnexB2, a as BC_MAGIC, b as eventTraceLog, c as BaichuanVideoStream, d as aesDecrypt, f as aesEncrypt, g as convertToAnnexB, h as bcHeaderHasPayloadOffset, i as BC_CLASS_MODERN_24, j as talkTraceLog, k as splitAnnexBToNalPayloads, l as BcMediaAnnexBDecoder, m as bcEncrypt, n as BC_CLASS_LEGACY, o as BC_MAGIC_REV, p as bcDecrypt, r as BC_CLASS_MODERN_20, t as BC_CLASS_FILE_DOWNLOAD, u as __require$1, v as debugLog, w as getH265NalType, x as extractPpsFromAnnexB, y as deriveAesKey } from "./chunk-KWWUCNIY-Ccq-OAGJ.mjs";
+import { A as splitAnnexBToNalPayloads2, C as extractVpsFromAnnexB, D as normalizeDebugOptions, E as md5StrModern, M as traceLog, O as recordingsTraceLog, S as extractSpsFromAnnexB, T as isH265Irap, _ as convertToAnnexB2, a as BC_MAGIC, b as eventTraceLog, c as BaichuanVideoStream, d as aesDecrypt, f as aesEncrypt, g as convertToAnnexB, h as bcHeaderHasPayloadOffset, i as BC_CLASS_MODERN_24, j as talkTraceLog, k as splitAnnexBToNalPayloads, l as BcMediaAnnexBDecoder, m as bcEncrypt, n as BC_CLASS_LEGACY, o as BC_MAGIC_REV, p as bcDecrypt, r as BC_CLASS_MODERN_20, t as BC_CLASS_FILE_DOWNLOAD, u as __require$1, v as debugLog, w as getH265NalType, x as extractPpsFromAnnexB, y as deriveAesKey } from "./chunk-ZQFQRCLQ-BNqCZtSS.mjs";
 import { createHash, randomBytes } from "node:crypto";
 import { EventEmitter } from "events";
 import * as fs2 from "fs";
@@ -5381,7 +5381,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-BDR76Ykr.mjs
+//#region ../types/dist/sleep-vl6nBE8d.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -31652,14 +31652,81 @@ function summarisePrivacyAudio(profiles) {
 	if (profiles.length === 0) return null;
 	return profiles.some((p) => p.audioEnabled);
 }
+/**
+* What a preset id DOES on this camera.
+*
+* On several PTZ firmwares the preset namespace is shared: low ids are stored
+* positions, a reserved band triggers camera FUNCTIONS. The dispensa camera
+* (Hikvision) returns its own reserved band in the preset list, named by the
+* firmware:
+*
+*   34 Back to origin · 39 Day mode · 40 Night mode · 46 Day/Night Auto Mode
+*   92 Set manual limits · 93 Save manual limits · 94 Remote reboot
+*   95 Call OSD menu
+*
+* We used to hand all of these to the UI as ordinary presets. Saving over one
+* is what produced `PUT /ISAPI/PTZCtrl/channels/1/presets/34 -> HTTP 500`: the
+* camera refusing to let "Back to origin" be overwritten, surfaced to the
+* operator as a transport failure.
+*
+* A function preset stays fully usable as a DESTINATION -- `goToPreset('34')`
+* is the single most useful thing that camera can do. Only `savePreset` and
+* `deletePreset` are gated.
+*/
+var PtzPresetFunctionSchema = _enum([
+	"home",
+	"day-mode",
+	"night-mode",
+	"day-night-auto",
+	"set-limits",
+	"save-limits",
+	"reboot",
+	"osd-menu"
+]);
 var PtzPresetSchema = object({
 	id: string(),
-	name: string()
+	name: string(),
+	/**
+	* The firmware function this id performs, when the provider KNOWS the id is
+	* reserved. `null` = an ordinary stored position, OR a reserved id this
+	* provider does not recognise -- the two are told apart by `writable`.
+	*/
+	fn: PtzPresetFunctionSchema.nullable(),
+	/**
+	* Whether `savePreset` / `deletePreset` may target this id. A provider sets
+	* it false only for a band it KNOWS is reserved; where the firmware is not
+	* documented it stays true and a refusal comes from the camera, named.
+	*/
+	writable: boolean()
 });
+/**
+* Where the head is pointing -- per axis, and `null` when the driver cannot
+* read it.
+*
+* It used to be three REQUIRED numbers, which left a provider that cannot read
+* position no way to say so. All four said `0`:
+*
+*   reolink   `return { pan: 0, tilt: 0, zoom: 0 }`  "until a position-query
+*                                                     path lands upstream"
+*   hikvision stub, "firmware-dependent and frequently absent"
+*   amcrest   stub, "no generic absolute-position read for this model family"
+*   onvif     throws
+*
+* So every consumer asking where a camera points was told "perfectly centred"
+* by four cameras that had never looked. That is D393 -- a measurement that
+* FAILED is `null`, never `0`, and the type says so all the way to the
+* decision -- the same shape as the unreadable `statfs` folded into "0 bytes of
+* headroom", which evacuated a healthy disk.
+*
+* D393 also says to check for a narrower structural TWIN of the result type.
+* There is one: `PtzStatusSchema` extends this, so the lie had already
+* propagated into `getStatus`, which is the surface `getPosition`'s own comment
+* tells callers to migrate to.
+*/
 var PtzPositionSchema = object({
-	pan: number(),
-	tilt: number(),
-	zoom: number()
+	pan: number().nullable(),
+	tilt: number().nullable(),
+	zoom: number().nullable()
 });
 var PtzMoveCommandSchema = object({
 	pan: number().optional(),
@@ -31681,7 +31748,72 @@ var PtzOptionsSchema = object({
 	maxPresets: number().optional(),
 	/** Whether the camera exposes a controllable autofocus toggle
 	*  (boolean `hasX` per the getOptions availability convention). */
-	hasAutofocus: boolean()
+	hasAutofocus: boolean(),
+	/**
+	* How many distinct speeds this camera's NATIVE scale offers.
+	*
+	* The cap's `speed` is normalized 0..1 and each provider maps it down --
+	* Baichuan 1..63, Dahua 1..8, ISAPI's percentage -100..100. The normalized
+	* value hides how coarse that really is: asking an amcrest for `0.37` is
+	* meaningless, because it has eight steps and three of them round to the
+	* same one. A loop that tunes its own gain has to know the granularity of
+	* the knob it is turning.
+	*
+	* `null` = the driver does not know, or the scale is continuous (ONVIF takes
+	* a float). Never a made-up number.
+	*/
+	speedSteps: number().int().positive().nullable(),
+	/**
+	* How long ONE `move` pulse runs on this driver, ms.
+	*
+	* `move` is a self-terminating burst everywhere, but every provider hardcoded
+	* its own duration in private -- 200 reolink, 350 amcrest, 500 hikvision,
+	* 1000 onvif -- so no caller could read it. It is the DENOMINATOR of "how far
+	* did the head travel per pulse": without it a measured displacement has no
+	* gain to be divided into.
+	*
+	* `null` = the driver cannot say.
+	*/
+	moveImpulseMs: number().int().positive().nullable()
+});
+/**
+* Which preset `goHome` goes to, and WHO decided.
+*
+* `goHome` used to be three vendor "conventions" written in three comments --
+* Reolink preset 0, Hikvision preset '1', Dahua preset 1 -- and on this fleet
+* not one of the three cameras honours its own:
+*
+*   592  Videocamera camera Daniel (reolink)   preset 0 holds "stanza"
+*   1438 Videocamera dispensa (hikvision)      preset 1 holds "Credenza"
+*   3836 Videocamera studio (amcrest)          preset 1 holds "Preset1"
+*
+* So `goHome` meant "go wherever the operator happened to save in slot 0 or 1",
+* and two of the three swallowed the failure in a bare `catch`. For autotrack
+* this is the HOTTEST path -- it runs every time a subject is released -- so it
+* needs an answer that is true per camera and audible when it is missing.
+*
+* `source` is what makes it honest:
+*   - `operator` -- picked in the UI, stored by the provider.
+*   - `firmware` -- the camera itself named a preset `fn: 'home'` (Hikvision's
+*     "Back to origin"), adopted as the default with nothing to configure.
+*   - `native`   -- the driver homes WITHOUT a preset at all. ONVIF does:
+*     `goHome` is `ptzAbsoluteMove({x:0, y:0, zoom:0})`. `presetId` is null and
+*     that is not a failure -- there is nothing to pick, and the UI must offer
+*     no picker.
+*   - `none`     -- nothing is configured and the camera names nothing.
+*     `goHome` REFUSES rather than moving the head somewhere arbitrary.
+*
+* `source === 'none'` is the refusal condition, NOT `presetId === null`: the
+* native case has no preset and homes perfectly well.
+*/
+var PtzHomePresetSchema = object({
+	presetId: string().nullable(),
+	source: _enum([
+		"operator",
+		"firmware",
+		"native",
+		"none"
+	])
 });
 var ptzCapability = {
 	name: "ptz",
@@ -31722,7 +31854,66 @@ var ptzCapability = {
 			auth: "admin"
 		}),
 		getOptions: method(object({ deviceId: number() }), PtzOptionsSchema),
+		/**
+		* Move to the camera's configured home preset. THROWS when
+		* `getHomePreset()` resolves to `none` -- a head that did not move must
+		* never look like a head that went home.
+		*/
 		goHome: method(object({ deviceId: number() }), _void(), { kind: "mutation" }),
+		/** Which preset `goHome` targets, and who decided it. */
+		getHomePreset: method(object({ deviceId: number() }), PtzHomePresetSchema),
+		/**
+		* Pin the home preset for this camera. `null` clears the operator's choice
+		* and falls back to whatever the firmware names, or to `none`.
+		*/
+		setHomePreset: method(object({
+			deviceId: number(),
+			presetId: string().nullable()
+		}), _void(), {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/**
+		* Make WHERE THE HEAD IS POINTING RIGHT NOW this camera's home.
+		*
+		* `setHomePreset` takes a preset id, and a preset id is the wrong shape for
+		* the most natural thing an operator does: aim the camera, then say "here".
+		* It is also the only shape a camera whose home is NOT a preset can accept
+		* -- Reolink's home is a guard point, a stored position with no id at all,
+		* and hiding the control for that case (as the UI briefly did) left the one
+		* vendor with a native home unable to set it.
+		*
+		* Each provider does it its own way:
+		*   reolink   `setGrd` with `needSetPos`, pinning the guard point here
+		*   hikvision / amcrest  save a preset, then pin it as home
+		*   onvif     REFUSES -- its home is the PTZ origin and cannot be moved
+		*
+		* A provider that cannot honour it throws rather than silently doing
+		* nothing: an operator who pressed "set home here" and saw no error would
+		* believe it took.
+		*/
+		captureHomeHere: method(object({ deviceId: number() }), _void(), {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/**
+		* How long the camera waits, idle, before returning home on its own --
+		* `null` when it has no such behaviour.
+		*
+		* Reolink's guard point carries one (`timeout`, freely settable in
+		* seconds). It is a real function of the camera that we did not expose at
+		* all, and it belongs next to the home it governs rather than in a vendor
+		* settings page nobody associates with Home.
+		*/
+		getHomeReturnSeconds: method(object({ deviceId: number() }), number().int().nullable()),
+		/** Set the idle-return delay. Refused by a camera that has no such timer. */
+		setHomeReturnSeconds: method(object({
+			deviceId: number(),
+			seconds: number().int().min(0).max(3600)
+		}), _void(), {
+			kind: "mutation",
+			auth: "admin"
+		}),
 		/**
 		* Pull the current PTZ position. Redundant with the auto-injected
 		* `getStatus` method (see `status` below); kept for callers that
@@ -41381,6 +41572,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"ptz.captureHomeHere": {
+		capName: "ptz",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"ptz.continuousMove": {
 		capName: "ptz",
 		capScope: "device",
@@ -41393,6 +41590,18 @@ Object.freeze({
 		addonId: null,
 		access: "delete"
 	},
+	"ptz.getHomePreset": {
+		capName: "ptz",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
+	"ptz.getHomeReturnSeconds": {
+		capName: "ptz",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"ptz.getOptions": {
 		capName: "ptz",
 		capScope: "device",
@@ -41441,6 +41650,18 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"ptz.setHomePreset": {
+		capName: "ptz",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
+	"ptz.setHomeReturnSeconds": {
+		capName: "ptz",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"ptz.stop": {
 		capName: "ptz",
 		capScope: "device",
@@ -44604,6 +44825,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"ptz.captureHomeHere": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"ptz.continuousMove": [{
 		name: "deviceId",
 		form: "single",
@@ -44614,6 +44840,16 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"ptz.getHomePreset": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"ptz.getHomeReturnSeconds": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"ptz.getOptions": [{
 		name: "deviceId",
 		form: "single",
@@ -44654,6 +44890,16 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"ptz.setHomePreset": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"ptz.setHomeReturnSeconds": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"ptz.stop": [{
 		name: "deviceId",
 		form: "single",
@@ -68338,7 +68584,7 @@ var require_yazl = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 }));
 //#endregion
-//#region node_modules/@apocaliss92/nodelink-js/dist/chunk-HL6TWIAL.js
+//#region node_modules/@apocaliss92/nodelink-js/dist/chunk-KWQVN7H5.js
 var import_undici = require_undici();
 var import_yazl = /* @__PURE__ */ __toESM(require_yazl(), 1);
 var FLAGS_CAM_V2 = {
@@ -74755,7 +75001,7 @@ var require_lz4 = /* @__PURE__ */ __commonJSMin(((exports) => {
 	};
 }));
 //#endregion
-//#region node_modules/@apocaliss92/nodelink-js/dist/chunk-3SEJZ2U5.js
+//#region node_modules/@apocaliss92/nodelink-js/dist/chunk-CE77DTET.js
 var import_fxp = require_fxp();
 var import_lz4 = /* @__PURE__ */ __toESM(require_lz4(), 1);
 function encodeHeader(h) {
@@ -75074,8 +75320,8 @@ function buildC2mQ(params) {
 	const os = params.os ?? "MAC";
 	return buildP2pXml(`<C2M_Q><uid>${xmlEscape(params.uid)}</uid><p>${xmlEscape(os)}</p></C2M_Q>`);
 }
-function parseIpPortBlock(tag, body) {
-	const m = new RegExp(`<${tag}>([\\s\\S]*?)</${tag}>`, "i").exec(body);
+function parseIpPortBlock(tag2, body) {
+	const m = new RegExp(`<${tag2}>([\\s\\S]*?)</${tag2}>`, "i").exec(body);
 	if (!m) return void 0;
 	const block = m[1] ?? "";
 	const ip = /<ip>([^<]+)<\/ip>/i.exec(block)?.[1];
@@ -75120,8 +75366,8 @@ function parseR2cCr(xml) {
 	if (!Number.isFinite(rsp)) return void 0;
 	const sidStr = /<sid>(-?\d+)<\/sid>/i.exec(body)?.[1];
 	const sid = sidStr != null ? Number(sidStr) : void 0;
-	const parseCustom = (tag) => {
-		const mm = new RegExp(`<${tag}>([\\s\\S]*?)</${tag}>`, "i").exec(body);
+	const parseCustom = (tag2) => {
+		const mm = new RegExp(`<${tag2}>([\\s\\S]*?)</${tag2}>`, "i").exec(body);
 		if (!mm) return void 0;
 		const block = mm[1] ?? "";
 		const ip = /<ip>([^<]+)<\/ip>/i.exec(block)?.[1];
@@ -76681,12 +76927,12 @@ function asLogger(logger) {
 		error: resolveMethod(base, "error"),
 		debug: resolveMethod(base, "debug")
 	};
-	out.child = (tag) => createTaggedLogger(out, tag);
+	out.child = (tag2) => createTaggedLogger(out, tag2);
 	return out;
 }
-function createTaggedLogger(base, tag) {
+function createTaggedLogger(base, tag2) {
 	const b = base.log ? base : asLogger(base);
-	const prefix = `[${tag}] `;
+	const prefix = `[${tag2}] `;
 	const wrap = (fn) => {
 		return (message, ...optionalParams) => {
 			if (typeof message === "string") fn(`${prefix}${message}`, ...optionalParams);
@@ -76713,7 +76959,7 @@ function createDebugGateLogger(base, enabled = false) {
 		error: b.error,
 		debug: enabled ? b.debug : noop
 	};
-	out.child = (tag) => createDebugGateLogger(createTaggedLogger(out, tag), enabled);
+	out.child = (tag2) => createDebugGateLogger(createTaggedLogger(out, tag2), enabled);
 	return out;
 }
 function isTalkCmd(cmdId) {
@@ -82407,29 +82653,29 @@ function parseSupportXml(xml) {
 	if (!match) return void 0;
 	const supportXml = match[1] ?? "";
 	const ptzMode = supportXml.match(/<ptzMode>([^<]*)<\/ptzMode>/i)?.[1];
-	const topLevelInt = (tag) => {
-		return toNumberOrUndefined(supportXml.match(new RegExp(`<${tag}>([^<]*)<\\/${tag}>`, "i"))?.[1]);
+	const topLevelInt = (tag2) => {
+		return toNumberOrUndefined(supportXml.match(new RegExp(`<${tag2}>([^<]*)<\\/${tag2}>`, "i"))?.[1]);
 	};
-	const topLevelString = (tag) => {
-		return supportXml.match(new RegExp(`<${tag}>([^<]*)<\\/${tag}>`, "i"))?.[1];
+	const topLevelString = (tag2) => {
+		return supportXml.match(new RegExp(`<${tag2}>([^<]*)<\\/${tag2}>`, "i"))?.[1];
 	};
 	const items = [];
 	for (const itemMatch of supportXml.matchAll(/<item[^>]*>([\s\S]*?)<\/item>/gi)) {
 		const itemXml = itemMatch[1] ?? "";
 		const item = { chnID: toNumberOrUndefined(itemXml.match(/<chnID>([^<]*)<\/chnID>/i)?.[1]) ?? 0 };
 		for (const tagMatch of itemXml.matchAll(/<([A-Za-z0-9_]+)>([^<]*)<\/\1>/g)) {
-			const tag = tagMatch[1];
+			const tag2 = tagMatch[1];
 			const value = tagMatch[2];
-			if (!tag) continue;
-			if (tag === "chnID") continue;
-			item[tag] = toNumberOrUndefined(value) ?? value;
+			if (!tag2) continue;
+			if (tag2 === "chnID") continue;
+			item[tag2] = toNumberOrUndefined(value) ?? value;
 		}
 		items.push(item);
 	}
 	const support = { items };
 	if (ptzMode !== void 0) support.ptzMode = ptzMode;
-	const assignInt = (key, tag) => {
-		const v = topLevelInt(tag);
+	const assignInt = (key, tag2) => {
+		const v = topLevelInt(tag2);
 		if (v !== void 0) support[key] = v;
 	};
 	assignInt("IOInputPortNum", "IOInputPortNum");
@@ -82656,15 +82902,15 @@ function extractCanvasFromShelterXml(xml) {
 	const yMatch = xml.match(/<topLeftY>(\d+)<\/topLeftY>/g) ?? [];
 	let canvasX = 0;
 	let canvasY = 0;
-	for (const tag of xMatch) {
-		const v = Number(tag.replace(/<\/?topLeftX>/g, "")) | 0;
+	for (const tag2 of xMatch) {
+		const v = Number(tag2.replace(/<\/?topLeftX>/g, "")) | 0;
 		if (v > 0) {
 			canvasX = v & 65535;
 			break;
 		}
 	}
-	for (const tag of yMatch) {
-		const v = Number(tag.replace(/<\/?topLeftY>/g, "")) | 0;
+	for (const tag2 of yMatch) {
+		const v = Number(tag2.replace(/<\/?topLeftY>/g, "")) | 0;
 		if (v > 0) {
 			canvasY = v & 65535;
 			break;
@@ -82677,9 +82923,9 @@ function extractCanvasFromShelterXml(xml) {
 }
 function parseRectTags(block) {
 	const out = {};
-	const grab = (tag) => {
-		const m = block.match(new RegExp(`<${tag}>([^<]*)<\\/${tag}>`));
-		if (m && m[1] !== void 0) out[tag] = m[1];
+	const grab = (tag2) => {
+		const m = block.match(new RegExp(`<${tag2}>([^<]*)<\\/${tag2}>`));
+		if (m && m[1] !== void 0) out[tag2] = m[1];
 	};
 	grab("id");
 	grab("name");
@@ -82924,9 +83170,9 @@ var buildDetectionClasses = (parsed, recordType) => {
 };
 var getXmlTexts = (xml, tags) => {
 	const out = {};
-	for (const tag of tags) {
-		const v = getXmlText(xml, tag);
-		if (v !== void 0) out[tag] = v;
+	for (const tag2 of tags) {
+		const v = getXmlText(xml, tag2);
+		if (v !== void 0) out[tag2] = v;
 	}
 	return out;
 };
@@ -83188,11 +83434,11 @@ function patchBlock(xml, block, fields) {
 	const end = xml.indexOf(`</${block}>`, start);
 	if (end < 0) return xml;
 	let body = xml.slice(start, end);
-	for (const [tag, value] of Object.entries(fields)) {
+	for (const [tag2, value] of Object.entries(fields)) {
 		if (value === void 0) continue;
 		const escaped = escapeXmlText(typeof value === "boolean" ? value ? "1" : "0" : String(value));
-		if (body.includes(`<${tag}>`)) body = body.replace(new RegExp(`<${tag}>[^<]*<\\/${tag}>`), `<${tag}>${escaped}</${tag}>`);
-		else body += `<${tag}>${escaped}</${tag}>`;
+		if (body.includes(`<${tag2}>`)) body = body.replace(new RegExp(`<${tag2}>[^<]*<\\/${tag2}>`), `<${tag2}>${escaped}</${tag2}>`);
+		else body += `<${tag2}>${escaped}</${tag2}>`;
 	}
 	return xml.slice(0, start) + body + xml.slice(end);
 }
@@ -83260,6 +83506,66 @@ var OSD_CORNER_LABELS = {
 	"bottom-left": "Bottom left",
 	"bottom-right": "Bottom right"
 };
+function wireFloat(value) {
+	return value.toExponential(6).replace(/e([+-])(\d)$/, "e$10$2");
+}
+function buildPtzGuardExtensionXml(channelId, direction) {
+	return `<?xml version="1.0" encoding="UTF-8" ?>
+<Extension version="1.1">
+<channelId>${channelId}</channelId>${direction === "read" ? `
+<chnType>0</chnType>` : ""}
+</Extension>
+`;
+}
+function guardBody(channelId, command, fields) {
+	return [
+		"<?xml version=\"1.0\" encoding=\"UTF-8\" ?>",
+		"<body>",
+		"<PtzGuard version=\"1.1\">",
+		`<channelId>${channelId}</channelId>`,
+		...fields,
+		`<command>${command}</command>`,
+		"<imageName></imageName>",
+		`<xpos>${wireFloat(0)}</xpos>`,
+		`<ypos>${wireFloat(0)}</ypos>`,
+		`<height>${wireFloat(0)}</height>`,
+		`<width>${wireFloat(0)}</width>`,
+		"<mode>global</mode>",
+		"</PtzGuard>",
+		"</body>",
+		""
+	].join("\n");
+}
+function buildPtzGuardGoXml(channelId) {
+	return guardBody(channelId, "toGrd", ["<benable>0</benable>", "<timeout>68</timeout>"]);
+}
+function buildPtzGuardSetXml(input) {
+	return guardBody(input.channelId, "setGrd", [
+		`<benable>${input.enabled ? 1 : 0}</benable>`,
+		`<timeout>${Math.round(input.timeoutSeconds)}</timeout>`,
+		...input.setPosition ? ["<needSetPos>1</needSetPos>"] : []
+	]);
+}
+function tag(xml, name) {
+	const m = new RegExp(`<${name}>([\\s\\S]*?)</${name}>`).exec(xml);
+	return m === null ? null : (m[1] ?? "").trim();
+}
+function parsePtzGuardXml(xml) {
+	if (!xml.includes("<PtzGuard")) return null;
+	const enabled = tag(xml, "benable");
+	const valid = tag(xml, "bvalid");
+	const timeout = tag(xml, "timeout");
+	if (enabled === null || valid === null || timeout === null) return null;
+	const timeoutSeconds = Number.parseInt(timeout, 10);
+	if (!Number.isFinite(timeoutSeconds)) return null;
+	return {
+		enabled: enabled === "1",
+		valid: valid === "1",
+		timeoutSeconds,
+		mode: tag(xml, "mode") ?? "global",
+		imageName: tag(xml, "imageName") ?? ""
+	};
+}
 var emitter = new EventEmitter();
 var lastEventByCamera = /* @__PURE__ */ new Map();
 var MAX_GLOBAL_EVENTS = 300;
@@ -84472,8 +84778,8 @@ var buildFileInfoListStopXml = (params) => {
 </body>`;
 };
 var sleepMs = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
-var xmlDateTimePayload = (tag, d) => {
-	return `<${tag}><year>${d.getFullYear()}</year><month>${d.getMonth() + 1}</month><day>${d.getDate()}</day><hour>${d.getHours()}</hour><minute>${d.getMinutes()}</minute><second>${d.getSeconds()}</second></${tag}>`;
+var xmlDateTimePayload = (tag2, d) => {
+	return `<${tag2}><year>${d.getFullYear()}</year><month>${d.getMonth() + 1}</month><day>${d.getDate()}</day><hour>${d.getHours()}</hour><minute>${d.getMinutes()}</minute><second>${d.getSeconds()}</second></${tag2}>`;
 };
 var buildFileInfoListOpenXml = (params) => {
 	return `<?xml version="1.0" encoding="UTF-8" ?>
@@ -84661,10 +84967,10 @@ var isPlausibleStream = (s) => {
 	return s.width > 0 && s.height > 0 && (s.frameRate > 0 || s.bitRate > 0);
 };
 var logDebugStreamBlock = (params) => {
-	const { logger, traceNativeStream, channel, tag, blockXml } = params;
+	const { logger, traceNativeStream, channel, tag: tag2, blockXml } = params;
 	if (!traceNativeStream) return;
 	if (!blockXml) {
-		(logger.warn ?? logger.log).call(logger, `[ReolinkBaichuanApi] getStreamMetadata(traceNativeStream): channel=${channel} tag=<${tag}> missing`);
+		(logger.warn ?? logger.log).call(logger, `[ReolinkBaichuanApi] getStreamMetadata(traceNativeStream): channel=${channel} tag=<${tag2}> missing`);
 		return;
 	}
 	const raw = blockXml;
@@ -84691,7 +84997,7 @@ var logDebugStreamBlock = (params) => {
 	const previewMax = 1400;
 	const xmlPreview = raw.length <= previewMax ? raw : raw.slice(0, previewMax) + `
 ...truncated (+${raw.length - previewMax} chars)`;
-	(logger.warn ?? logger.log).call(logger, `[ReolinkBaichuanApi] getStreamMetadata(traceNativeStream): channel=${channel} tag=<${tag}> enabled=${isEnabled} plausible=${plausible} width=${width} height=${height} frame=${frameRate} bitRate=${bitRate} audio=${audio} videoEncType=${videoEncTypeText ?? "?"} rawFields=${JSON.stringify({
+	(logger.warn ?? logger.log).call(logger, `[ReolinkBaichuanApi] getStreamMetadata(traceNativeStream): channel=${channel} tag=<${tag2}> enabled=${isEnabled} plausible=${plausible} width=${width} height=${height} frame=${frameRate} bitRate=${bitRate} audio=${audio} videoEncType=${videoEncTypeText ?? "?"} rawFields=${JSON.stringify({
 		widthText,
 		heightText,
 		frameText,
@@ -84784,20 +85090,20 @@ var parseChannelStreamMetadataFromGetEncXml = (params) => {
 			audioEnabled = audioEnabled && s.audio === 1;
 		}
 	}
-	for (const tag of [
+	for (const tag2 of [
 		"extStream",
 		"thirdStream",
 		"externStream",
 		"extraStream"
 	]) {
-		const extMatch = xml.match(new RegExp(`<${tag}[^>]*>([\\s\\S]*?)<\\/${tag}>`));
+		const extMatch = xml.match(new RegExp(`<${tag2}[^>]*>([\\s\\S]*?)<\\/${tag2}>`));
 		if (!extMatch) continue;
 		const extXml = extMatch[1] ?? "";
 		logDebugStreamBlock({
 			logger,
 			traceNativeStream,
 			channel,
-			tag,
+			tag: tag2,
 			blockXml: extXml
 		});
 		const s = buildStream({
@@ -86390,7 +86696,7 @@ var ReolinkBaichuanApi = class _ReolinkBaichuanApi {
 	* @param logger - Optional logger for debug output
 	* @returns The socket and a release function
 	*/
-	async acquirePooledSocket(tag, logger) {
+	async acquirePooledSocket(tag2, logger) {
 		const log = logger ?? this.logger;
 		const now = Date.now();
 		const cooldownEntry = this.socketPoolCooldowns.get(this.host);
@@ -86401,12 +86707,12 @@ var ReolinkBaichuanApi = class _ReolinkBaichuanApi {
 			} else if (now < cooldownEntry.cooldownUntil) {
 				const remainingMs = cooldownEntry.cooldownUntil - now;
 				const reason = this.lastD2cDiscAtMs > 0 && now - this.lastD2cDiscAtMs < 12e4 ? "D2C_DISC (camera sleeping)" : "repeated login failures";
-				const error = /* @__PURE__ */ new Error(`[SocketPool] Host ${this.host} is in cooldown for ${Math.ceil(remainingMs / 1e3)}s due to ${reason}. tag=${tag}`);
+				const error = /* @__PURE__ */ new Error(`[SocketPool] Host ${this.host} is in cooldown for ${Math.ceil(remainingMs / 1e3)}s due to ${reason}. tag=${tag2}`);
 				log?.debug?.(error.message);
 				throw error;
 			}
 		}
-		const existing = this.socketPool.get(tag);
+		const existing = this.socketPool.get(tag2);
 		if (existing) {
 			if (existing.idleCloseTimer) {
 				clearTimeout(existing.idleCloseTimer);
@@ -86416,35 +86722,35 @@ var ReolinkBaichuanApi = class _ReolinkBaichuanApi {
 				const client2 = await existing.pendingPromise;
 				existing.refCount++;
 				existing.lastUsedAt = Date.now();
-				log?.debug?.(`[SocketPool] Waited for pending socket creation for tag=${tag} (refCount=${existing.refCount})`);
+				log?.debug?.(`[SocketPool] Waited for pending socket creation for tag=${tag2} (refCount=${existing.refCount})`);
 				return {
 					client: client2,
-					release: () => this.releasePooledSocket(tag, logger)
+					release: () => this.releasePooledSocket(tag2, logger)
 				};
 			}
 			if (existing.refCount === 0) {
 				existing.refCount = 1;
 				existing.lastUsedAt = Date.now();
-				log?.debug?.(`[SocketPool] Reusing idle socket for tag=${tag}`);
+				log?.debug?.(`[SocketPool] Reusing idle socket for tag=${tag2}`);
 				try {
 					if (!existing.client.loggedIn) await existing.client.login();
 				} catch {}
 				if (existing.client.loggedIn) return {
 					client: existing.client,
-					release: () => this.releasePooledSocket(tag, logger)
+					release: () => this.releasePooledSocket(tag2, logger)
 				};
-			} else if (tag.startsWith("replay:")) log?.debug?.(`[SocketPool] Preempting active replay socket for tag=${tag}`);
+			} else if (tag2.startsWith("replay:")) log?.debug?.(`[SocketPool] Preempting active replay socket for tag=${tag2}`);
 			else {
 				existing.refCount++;
 				existing.lastUsedAt = Date.now();
-				log?.debug?.(`[SocketPool] Reusing active socket for tag=${tag} (refCount=${existing.refCount})`);
+				log?.debug?.(`[SocketPool] Reusing active socket for tag=${tag2} (refCount=${existing.refCount})`);
 				return {
 					client: existing.client,
-					release: () => this.releasePooledSocket(tag, logger)
+					release: () => this.releasePooledSocket(tag2, logger)
 				};
 			}
-			log?.debug?.(`[SocketPool] Closing existing socket for tag=${tag} (recreating)`);
-			this.socketPool.delete(tag);
+			log?.debug?.(`[SocketPool] Closing existing socket for tag=${tag2} (recreating)`);
+			this.socketPool.delete(tag2);
 			if (existing.generalPermitRelease) {
 				try {
 					existing.generalPermitRelease();
@@ -86457,10 +86763,10 @@ var ReolinkBaichuanApi = class _ReolinkBaichuanApi {
 					skipLogout: true
 				});
 			} catch (e) {
-				log?.warn?.(`[SocketPool] Error closing old socket for tag=${tag}: ${e}`);
+				log?.warn?.(`[SocketPool] Error closing old socket for tag=${tag2}: ${e}`);
 			}
 		}
-		log?.log?.(`[SocketPool] Creating new socket for tag=${tag}`);
+		log?.log?.(`[SocketPool] Creating new socket for tag=${tag2}`);
 		const entry = {
 			client: void 0,
 			refCount: 0,
@@ -86477,7 +86783,7 @@ var ReolinkBaichuanApi = class _ReolinkBaichuanApi {
 				} : this.clientOptions);
 				this.attachD2cDiscListener(newClient);
 				newClient.on("error", (err) => {
-					log?.debug?.(`[SocketPool] tag=${tag} client error: ${err?.message ?? err}`);
+					log?.debug?.(`[SocketPool] tag=${tag2} client error: ${err?.message ?? err}`);
 				});
 				await newClient.login();
 				const existingCooldown = this.socketPoolCooldowns.get(this.host);
@@ -86489,10 +86795,10 @@ var ReolinkBaichuanApi = class _ReolinkBaichuanApi {
 				entry.refCount = 1;
 				entry.lastUsedAt = Date.now();
 				delete entry.pendingPromise;
-				log?.log?.(`[SocketPool] Socket connected for tag=${tag}`);
-				if (tag !== "general") try {
+				log?.log?.(`[SocketPool] Socket connected for tag=${tag2}`);
+				if (tag2 !== "general") try {
 					const generalEntry = this.socketPool.get("general");
-					if (generalEntry?.client) entry.generalPermitRelease = generalEntry.client.acquirePermit(0, `streaming-peer:${tag}`);
+					if (generalEntry?.client) entry.generalPermitRelease = generalEntry.client.acquirePermit(0, `streaming-peer:${tag2}`);
 				} catch {}
 				if (this.sessionGuardEnabled) this.maybeRebootOnTooManySessions();
 				return newClient;
@@ -86503,21 +86809,21 @@ var ReolinkBaichuanApi = class _ReolinkBaichuanApi {
 				if (failureCount >= _ReolinkBaichuanApi.SOCKET_POOL_FAILURE_THRESHOLD) {
 					const backoffMs = Math.min(_ReolinkBaichuanApi.SOCKET_POOL_BASE_COOLDOWN_MS * Math.pow(2, failureCount - _ReolinkBaichuanApi.SOCKET_POOL_FAILURE_THRESHOLD), _ReolinkBaichuanApi.SOCKET_POOL_MAX_COOLDOWN_MS);
 					cooldownUntil = now2 + backoffMs;
-					log?.warn?.(`[SocketPool] Login failed for host=${this.host} (failure #${failureCount}). Entering cooldown for ${Math.ceil(backoffMs / 1e3)}s. tag=${tag}`);
-				} else log?.warn?.(`[SocketPool] Login failed for host=${this.host} (failure #${failureCount}/${_ReolinkBaichuanApi.SOCKET_POOL_FAILURE_THRESHOLD} before cooldown). tag=${tag}`);
+					log?.warn?.(`[SocketPool] Login failed for host=${this.host} (failure #${failureCount}). Entering cooldown for ${Math.ceil(backoffMs / 1e3)}s. tag=${tag2}`);
+				} else log?.warn?.(`[SocketPool] Login failed for host=${this.host} (failure #${failureCount}/${_ReolinkBaichuanApi.SOCKET_POOL_FAILURE_THRESHOLD} before cooldown). tag=${tag2}`);
 				this.socketPoolCooldowns.set(this.host, {
 					failureCount,
 					lastFailureAt: now2,
 					cooldownUntil
 				});
-				this.socketPool.delete(tag);
+				this.socketPool.delete(tag2);
 				throw loginError;
 			}
 		})();
-		this.socketPool.set(tag, entry);
+		this.socketPool.set(tag2, entry);
 		return {
 			client: await entry.pendingPromise,
-			release: () => this.releasePooledSocket(tag, logger)
+			release: () => this.releasePooledSocket(tag2, logger)
 		};
 	}
 	/**
@@ -86525,31 +86831,31 @@ var ReolinkBaichuanApi = class _ReolinkBaichuanApi {
 	* For shared sockets (general, streaming), just decrements refCount.
 	* For replay sockets, schedules idle close.
 	*/
-	async releasePooledSocket(tag, logger) {
+	async releasePooledSocket(tag2, logger) {
 		const log = logger ?? this.logger;
-		const entry = this.socketPool.get(tag);
+		const entry = this.socketPool.get(tag2);
 		if (!entry) return;
 		entry.refCount = Math.max(0, entry.refCount - 1);
 		entry.lastUsedAt = Date.now();
-		log?.debug?.(`[SocketPool] Released socket for tag=${tag} (refCount=${entry.refCount})`);
+		log?.debug?.(`[SocketPool] Released socket for tag=${tag2} (refCount=${entry.refCount})`);
 		if (entry.refCount > 0) return;
-		const isReplayTag = tag.startsWith("replay:");
-		const isStreamingTag = tag.startsWith("streaming:");
-		if (tag === "general") return;
+		const isReplayTag = tag2.startsWith("replay:");
+		const isStreamingTag = tag2.startsWith("streaming:");
+		if (tag2 === "general") return;
 		if (isStreamingTag) {
 			if (entry.idleCloseTimer) return;
 			entry.idleCloseTimer = setTimeout(async () => {
-				const current = this.socketPool.get(tag);
+				const current = this.socketPool.get(tag2);
 				if (!current) return;
 				if (current.refCount > 0) return;
-				this.socketPool.delete(tag);
+				this.socketPool.delete(tag2);
 				if (current.generalPermitRelease) {
 					try {
 						current.generalPermitRelease();
 					} catch {}
 					current.generalPermitRelease = void 0;
 				}
-				log?.log?.(`[SocketPool] Closing idle streaming socket for tag=${tag}`);
+				log?.log?.(`[SocketPool] Closing idle streaming socket for tag=${tag2}`);
 				try {
 					await current.client.close({
 						reason: "streaming idle close",
@@ -86562,11 +86868,11 @@ var ReolinkBaichuanApi = class _ReolinkBaichuanApi {
 		if (isReplayTag) {
 			if (entry.idleCloseTimer) return;
 			entry.idleCloseTimer = setTimeout(async () => {
-				const current = this.socketPool.get(tag);
+				const current = this.socketPool.get(tag2);
 				if (!current) return;
 				if (current.refCount > 0) return;
-				this.socketPool.delete(tag);
-				log?.debug?.(`[SocketPool] Closing idle replay socket for tag=${tag} (keepalive expired)`);
+				this.socketPool.delete(tag2);
+				log?.debug?.(`[SocketPool] Closing idle replay socket for tag=${tag2} (keepalive expired)`);
 				try {
 					await current.client.close({
 						reason: "replay idle keepalive expired",
@@ -86576,24 +86882,24 @@ var ReolinkBaichuanApi = class _ReolinkBaichuanApi {
 			}, _ReolinkBaichuanApi.SOCKET_POOL_KEEPALIVE_MS);
 			return;
 		}
-		this.socketPool.delete(tag);
+		this.socketPool.delete(tag2);
 		try {
 			await entry.client.close({
 				reason: "socket pool release",
 				skipLogout: true
 			});
-			log?.log?.(`[SocketPool] Closed socket for tag=${tag}`);
+			log?.log?.(`[SocketPool] Closed socket for tag=${tag2}`);
 		} catch (e) {
-			log?.warn?.(`[SocketPool] Error closing socket for tag=${tag}: ${e}`);
+			log?.warn?.(`[SocketPool] Error closing socket for tag=${tag2}: ${e}`);
 		}
 	}
 	/**
 	* Force-close a socket by tag.
 	* Used to preempt existing connections before acquiring a new one.
 	*/
-	async forceClosePooledSocket(tag, logger) {
+	async forceClosePooledSocket(tag2, logger) {
 		const log = logger ?? this.logger;
-		const entry = this.socketPool.get(tag);
+		const entry = this.socketPool.get(tag2);
 		if (!entry) return false;
 		if (entry.idleCloseTimer) {
 			clearTimeout(entry.idleCloseTimer);
@@ -86605,16 +86911,16 @@ var ReolinkBaichuanApi = class _ReolinkBaichuanApi {
 			} catch {}
 			entry.generalPermitRelease = void 0;
 		}
-		log?.debug?.(`[SocketPool] Force-closing socket for tag=${tag}`);
-		this.socketPool.delete(tag);
+		log?.debug?.(`[SocketPool] Force-closing socket for tag=${tag2}`);
+		this.socketPool.delete(tag2);
 		try {
 			await entry.client.close({
 				reason: "force closed",
 				skipLogout: true
 			});
-			log?.log?.(`[SocketPool] Force-closed socket for tag=${tag}`);
+			log?.log?.(`[SocketPool] Force-closed socket for tag=${tag2}`);
 		} catch (e) {
-			log?.warn?.(`[SocketPool] Error during force-close for tag=${tag}: ${e}`);
+			log?.warn?.(`[SocketPool] Error during force-close for tag=${tag2}: ${e}`);
 		}
 		return true;
 	}
@@ -86624,7 +86930,7 @@ var ReolinkBaichuanApi = class _ReolinkBaichuanApi {
 	async cleanupSocketPool() {
 		const entries = Array.from(this.socketPool.entries());
 		this.socketPool.clear();
-		await Promise.allSettled(entries.map(async ([tag, entry]) => {
+		await Promise.allSettled(entries.map(async ([tag2, entry]) => {
 			try {
 				if (entry.idleCloseTimer) clearTimeout(entry.idleCloseTimer);
 				if (entry.generalPermitRelease) {
@@ -86633,7 +86939,7 @@ var ReolinkBaichuanApi = class _ReolinkBaichuanApi {
 					} catch {}
 					entry.generalPermitRelease = void 0;
 				}
-				this.logger?.debug?.(`[SocketPool] Cleanup: closing tag=${tag}`);
+				this.logger?.debug?.(`[SocketPool] Cleanup: closing tag=${tag2}`);
 				await entry.client.close({
 					reason: "API cleanup",
 					skipLogout: true
@@ -86666,17 +86972,17 @@ var ReolinkBaichuanApi = class _ReolinkBaichuanApi {
 	* ```
 	*/
 	async createDedicatedSession(sessionKey, logger) {
-		const tag = this.resolveSocketTag(sessionKey);
-		(logger ?? this.logger)?.debug?.(`[SocketPool] createDedicatedSession sessionKey=${sessionKey} \u2192 tag=${tag}`);
-		return await this.acquirePooledSocket(tag, logger);
+		const tag2 = this.resolveSocketTag(sessionKey);
+		(logger ?? this.logger)?.debug?.(`[SocketPool] createDedicatedSession sessionKey=${sessionKey} \u2192 tag=${tag2}`);
+		return await this.acquirePooledSocket(tag2, logger);
 	}
 	/**
 	* @deprecated Use forceClosePooledSocket via createDedicatedSession instead.
 	* Force-close a dedicated client if it exists.
 	*/
 	async forceCloseDedicatedClient(sessionKey, logger) {
-		const tag = this.resolveSocketTag(sessionKey);
-		return await this.forceClosePooledSocket(tag, logger);
+		const tag2 = this.resolveSocketTag(sessionKey);
+		return await this.forceClosePooledSocket(tag2, logger);
 	}
 	/**
 	* @deprecated Cleanup handled by cleanupSocketPool now.
@@ -86691,8 +86997,8 @@ var ReolinkBaichuanApi = class _ReolinkBaichuanApi {
 		const debugCfg = this.client.getDebugConfig?.();
 		if (debugCfg) {
 			const sid = this.client.getSocketSessionId?.();
-			const tag = sid ? `ReolinkSimpleEvent sid=${sid}` : "ReolinkSimpleEvent";
-			eventTraceLog(debugCfg, this.logger, tag, `dispatch type=${evt.type} channel=${evt.channel} timestamp=${evt.timestamp}`);
+			const tag2 = sid ? `ReolinkSimpleEvent sid=${sid}` : "ReolinkSimpleEvent";
+			eventTraceLog(debugCfg, this.logger, tag2, `dispatch type=${evt.type} channel=${evt.channel} timestamp=${evt.timestamp}`);
 		}
 		for (const cb of this.simpleEventListeners) try {
 			Promise.resolve(cb(evt)).catch((e) => {
@@ -87290,7 +87596,7 @@ var ReolinkBaichuanApi = class _ReolinkBaichuanApi {
 			return;
 		}
 		entry.startInFlight = (async () => {
-			const { BaichuanVideoStream: BaichuanVideoStream2 } = await import("./BaichuanVideoStream-PBJL3EB5-D-etWPiW.mjs");
+			const { BaichuanVideoStream: BaichuanVideoStream2 } = await import("./BaichuanVideoStream-2M4UO7MB-CB-tIHMA.mjs");
 			const sessionKey = `live:object-detections:ch${entry.channel}:${entry.profile}`;
 			const dedicated = await this.createDedicatedSession(sessionKey);
 			const stream = new BaichuanVideoStream2({
@@ -87857,8 +88163,8 @@ var ReolinkBaichuanApi = class _ReolinkBaichuanApi {
 		const idleTimeoutMs = options?.idleTimeoutMs ?? 3e4;
 		const sessionKey = `talk:${options?.deviceId ?? "unknown"}:ch${channel}:${Date.now()}`;
 		logger?.info?.(`[DedicatedTalk] Creating session: ${sessionKey} (idleTimeout=${idleTimeoutMs}ms)`);
-		const tag = this.resolveSocketTag(sessionKey);
-		const { client: dedicatedClient, release } = await this.acquirePooledSocket(tag, logger);
+		const tag2 = this.resolveSocketTag(sessionKey);
+		const { client: dedicatedClient, release } = await this.acquirePooledSocket(tag2, logger);
 		const summary = this.getSocketPoolSummary();
 		logger?.info?.(`[DedicatedTalk] Session created [sessions: ${summary.count} active${summary.count > 0 ? ` (${summary.tags.join(", ")})` : ""}]`);
 		try {
@@ -87971,8 +88277,8 @@ var ReolinkBaichuanApi = class _ReolinkBaichuanApi {
 	}
 	/** SetNetPort via Baichuan: cmd_id 36 (enable/disable rtsp/rtmp/onvif/http/https) */
 	async setPortEnabled(params) {
-		const tag = `${params.port[0].toUpperCase()}${params.port.slice(1)}Port`;
-		const xml = `<?xml version="1.0" encoding="UTF-8" ?><body><${tag} version="1.1"><enable>${params.enable ? 1 : 0}</enable></${tag}></body>`;
+		const tag2 = `${params.port[0].toUpperCase()}${params.port.slice(1)}Port`;
+		const xml = `<?xml version="1.0" encoding="UTF-8" ?><body><${tag2} version="1.1"><enable>${params.enable ? 1 : 0}</enable></${tag2}></body>`;
 		await this.sendXml({
 			cmdId: 36,
 			payloadXml: xml
@@ -88003,13 +88309,13 @@ var ReolinkBaichuanApi = class _ReolinkBaichuanApi {
 	*/
 	async setPortConfig(patch) {
 		const blocks = [];
-		const append = (tag, portField, cfg) => {
+		const append = (tag2, portField, cfg) => {
 			if (!cfg) return;
 			if (cfg.port === void 0 && cfg.enable === void 0) return;
 			const inner = [];
 			if (cfg.port !== void 0) inner.push(`<${portField}>${cfg.port}</${portField}>`);
 			if (cfg.enable !== void 0) inner.push(`<enable>${cfg.enable ? 1 : 0}</enable>`);
-			blocks.push(`<${tag} version="1.1">${inner.join("")}</${tag}>`);
+			blocks.push(`<${tag2} version="1.1">${inner.join("")}</${tag2}>`);
 		};
 		append("ServerPort", "serverPort", patch.server);
 		append("HttpPort", "httpPort", patch.http);
@@ -88523,8 +88829,8 @@ var ReolinkBaichuanApi = class _ReolinkBaichuanApi {
 		];
 		const current = await this.getEncXml(ch);
 		let updated = null;
-		for (const tag of candidateTags) {
-			const sectionRe = new RegExp(`(<${tag}[^>]*>[\\s\\S]*?<videoEncType>)(\\d+)(</videoEncType>)`);
+		for (const tag2 of candidateTags) {
+			const sectionRe = new RegExp(`(<${tag2}[^>]*>[\\s\\S]*?<videoEncType>)(\\d+)(</videoEncType>)`);
 			if (!sectionRe.test(current)) continue;
 			const next = current.replace(sectionRe, `$1${desired}$3`);
 			if (next !== current) {
@@ -89054,9 +89360,9 @@ var ReolinkBaichuanApi = class _ReolinkBaichuanApi {
 		const streamType = params.streamType;
 		const logger = params.logger ?? this.logger;
 		const sessionKey = params.deviceId ? `replay:${params.deviceId}:ch${channel}` : `replay:standalone:ch${channel}:${Date.now()}`;
-		const tag = this.resolveSocketTag(sessionKey);
-		logger?.debug?.(`[startRecordingReplayStreamStandalone] sessionKey=${sessionKey} -> tag=${tag}`);
-		const { client: dedicatedClient, release: releaseDedicatedClient } = await this.acquirePooledSocket(tag, logger);
+		const tag2 = this.resolveSocketTag(sessionKey);
+		logger?.debug?.(`[startRecordingReplayStreamStandalone] sessionKey=${sessionKey} -> tag=${tag2}`);
+		const { client: dedicatedClient, release: releaseDedicatedClient } = await this.acquirePooledSocket(tag2, logger);
 		const uid = await this.ensureUidForRecordings(channel, void 0);
 		const payloadXml = buildFileInfoListReplayByNameXml({
 			channel,
@@ -89159,8 +89465,8 @@ var ReolinkBaichuanApi = class _ReolinkBaichuanApi {
 		const streamType = params.streamType;
 		const logger = params.logger ?? this.logger;
 		const sessionKey = params.deviceId ? `replay:${params.deviceId}:ch${channel}` : `replay:nvr:ch${channel}:${Date.now()}`;
-		const tag = this.resolveSocketTag(sessionKey);
-		const { client: dedicatedClient, release: releaseDedicatedClient } = await this.acquirePooledSocket(tag, logger);
+		const tag2 = this.resolveSocketTag(sessionKey);
+		const { client: dedicatedClient, release: releaseDedicatedClient } = await this.acquirePooledSocket(tag2, logger);
 		let uid;
 		try {
 			uid = await this.ensureUidForRecordings(channel, void 0);
@@ -91387,6 +91693,73 @@ ${stderr}`));
 		return result;
 	}
 	/**
+	* Read the PTZ guard point ("monitoring point" in the app).
+	*
+	* cmd_id: 332
+	*
+	* Returns `null` when the camera has no readable guard configuration — never
+	* a fabricated "none", because that answer is what a consumer uses to decide
+	* whether to move the head.
+	*/
+	async getPtzGuard(channel) {
+		const ch = this.normalizeChannel(channel);
+		return parsePtzGuardXml(await this.sendXml({
+			cmdId: 332,
+			channel: ch,
+			channelIdOverride: ch,
+			extensionXml: buildPtzGuardExtensionXml(ch, "read"),
+			messageClass: BC_CLASS_MODERN_24,
+			streamType: 0
+		}));
+	}
+	/**
+	* Configure the PTZ guard point.
+	*
+	* cmd_id: 331 with `<command>setGrd</command>`
+	*
+	* `setPosition` pins the guard point to the head's CURRENT position. Leave it
+	* false when only changing the timeout or the enable flag: re-sending it
+	* would silently move a point the operator had already placed.
+	*/
+	async setPtzGuard(options, channel) {
+		const ch = this.normalizeChannel(channel);
+		await this.sendXml({
+			cmdId: 331,
+			channel: ch,
+			channelIdOverride: ch,
+			extensionXml: buildPtzGuardExtensionXml(ch, "write"),
+			payloadXml: buildPtzGuardSetXml({
+				channelId: ch,
+				enabled: options.enabled,
+				timeoutSeconds: options.timeoutSeconds,
+				setPosition: options.setPosition === true
+			}),
+			messageClass: BC_CLASS_MODERN_24,
+			streamType: 0
+		});
+	}
+	/**
+	* Send the head to the guard point NOW.
+	*
+	* cmd_id: 331 with `<command>toGrd</command>`
+	*
+	* This is the closest thing Baichuan has to a "go home": the guard point is
+	* an operator-placed position, unlike preset slot 0 which merely happens to
+	* be first.
+	*/
+	async goToPtzGuard(channel) {
+		const ch = this.normalizeChannel(channel);
+		await this.sendXml({
+			cmdId: 331,
+			channel: ch,
+			channelIdOverride: ch,
+			extensionXml: buildPtzGuardExtensionXml(ch, "write"),
+			payloadXml: buildPtzGuardGoXml(ch),
+			messageClass: BC_CLASS_MODERN_24,
+			streamType: 0
+		});
+	}
+	/**
 	* Read zoom/focus min/max/current positions.
 	* cmd_id: 294 (MSG_ID_GET_ZOOM_FOCUS)
 	*/
@@ -91479,10 +91852,10 @@ ${stderr}`));
 	notifyD2cDisc() {
 		const now = Date.now();
 		this.lastD2cDiscAtMs = now;
-		const streamingTags = Array.from(this.socketPool.keys()).filter((tag) => tag.startsWith("streaming:"));
+		const streamingTags = Array.from(this.socketPool.keys()).filter((tag2) => tag2.startsWith("streaming:"));
 		if (streamingTags.length > 0) {
 			this.logger?.log?.(`[D2C_DISC] Force-closing ${streamingTags.length} streaming socket(s): ${streamingTags.join(", ")}`);
-			for (const tag of streamingTags) this.forceClosePooledSocket(tag, this.logger).catch(() => {});
+			for (const tag2 of streamingTags) this.forceClosePooledSocket(tag2, this.logger).catch(() => {});
 		}
 		const immediateCooldownUntil = now + _ReolinkBaichuanApi.D2C_DISC_IMMEDIATE_COOLDOWN_MS;
 		const existing = this.socketPoolCooldowns.get(this.host);
@@ -91515,15 +91888,15 @@ ${stderr}`));
 	* Returns undefined if the client is not in the pool (e.g. it's the general socket used directly).
 	*/
 	findSocketTagForClient(client) {
-		for (const [tag, entry] of this.socketPool) if (entry.client === client) return tag;
+		for (const [tag2, entry] of this.socketPool) if (entry.client === client) return tag2;
 	}
 	/**
 	* Reset the consecutive stream-start timeout counter for a streaming socket.
 	* Called on successful stream start.
 	*/
 	resetStreamTimeoutCounter(client) {
-		const tag = this.findSocketTagForClient(client);
-		if (tag) this.consecutiveStreamTimeouts.delete(tag);
+		const tag2 = this.findSocketTagForClient(client);
+		if (tag2) this.consecutiveStreamTimeouts.delete(tag2);
 	}
 	/**
 	* Track a stream-start timeout on a streaming socket.
@@ -91531,14 +91904,14 @@ ${stderr}`));
 	* socket so the next attempt creates a fresh connection.
 	*/
 	trackStreamTimeout(client) {
-		const tag = this.findSocketTagForClient(client);
-		if (!tag || !tag.startsWith("streaming:")) return;
-		const count = (this.consecutiveStreamTimeouts.get(tag) ?? 0) + 1;
-		this.consecutiveStreamTimeouts.set(tag, count);
+		const tag2 = this.findSocketTagForClient(client);
+		if (!tag2 || !tag2.startsWith("streaming:")) return;
+		const count = (this.consecutiveStreamTimeouts.get(tag2) ?? 0) + 1;
+		this.consecutiveStreamTimeouts.set(tag2, count);
 		if (count >= _ReolinkBaichuanApi.MAX_CONSECUTIVE_STREAM_TIMEOUTS) {
-			this.logger?.warn?.(`[SocketPool] ${count} consecutive stream timeouts on tag=${tag}, force-closing socket`);
-			this.consecutiveStreamTimeouts.delete(tag);
-			this.forceClosePooledSocket(tag, this.logger).catch(() => {});
+			this.logger?.warn?.(`[SocketPool] ${count} consecutive stream timeouts on tag=${tag2}, force-closing socket`);
+			this.consecutiveStreamTimeouts.delete(tag2);
+			this.forceClosePooledSocket(tag2, this.logger).catch(() => {});
 		}
 	}
 	/**
@@ -92405,8 +92778,20 @@ ${xml}`);
 		const support = supportResult.status === "fulfilled" ? supportResult.value : void 0;
 		const abilities = abilitiesResult.status === "fulfilled" ? abilitiesResult.value : void 0;
 		const supportItem = getSupportItemForChannel(support, ch);
+		let model;
+		try {
+			const info = await this.getInfo(void 0, { timeoutMs: 5e3 });
+			model = typeof info?.type === "string" ? info.type : void 0;
+		} catch (e) {
+			this.logger.debug("[ReolinkBaichuanApi] getDeviceCapabilities: getInfo(type) failed", {
+				host: this.host,
+				channel: ch,
+				err: e instanceof Error ? e.message : String(e)
+			});
+		}
 		const capabilities = computeDeviceCapabilities({
 			channel: ch,
+			...model != null && { model },
 			...support != null && { support },
 			...abilities != null && { abilities }
 		});
@@ -93175,7 +93560,7 @@ ${xml}`);
 	* @returns Test results for all stream types and profiles
 	*/
 	async testChannelStreams(channel, logger) {
-		const { testChannelStreams } = await import("./DiagnosticsTools-TID5M22B-9NV95vRN.mjs");
+		const { testChannelStreams } = await import("./DiagnosticsTools-GOFDNGAY-9NV95vRN.mjs");
 		return await testChannelStreams({
 			api: this,
 			channel: this.normalizeChannel(channel),
@@ -93191,7 +93576,7 @@ ${xml}`);
 	* @returns Complete diagnostics for all channels and streams
 	*/
 	async collectMultifocalDiagnostics(logger) {
-		const { collectMultifocalDiagnostics } = await import("./DiagnosticsTools-TID5M22B-9NV95vRN.mjs");
+		const { collectMultifocalDiagnostics } = await import("./DiagnosticsTools-GOFDNGAY-9NV95vRN.mjs");
 		return await collectMultifocalDiagnostics({
 			api: this,
 			logger
@@ -148318,6 +148703,17 @@ var ReolinkStreamProfileOptionsSchema = object({
 	}).optional()
 });
 var reolinkCameraSchema = object({
+	/**
+	* Which preset `ptz.goHome` targets on THIS camera.
+	*
+	* Empty = nothing configured, and `goHome` then REFUSES. It used to go to a
+	* hardcoded slot on a vendor "convention" this fleet contradicts: reolink
+	* went to preset 0, which on device 592 holds "stanza"; amcrest went to
+	* preset 1, which on device 3836 holds "Preset1". Both swallowed the failure
+	* in a bare catch, so a head that never moved was indistinguishable from a
+	* head that went home.
+	*/
+	homePresetId: string().default("").describe("Preset id ptz.goHome targets (empty = goHome refuses)"),
 	host: string().describe("Camera IP or hostname"),
 	port: number().default(9e3).describe("Baichuan port (default 9000)"),
 	username: string().default("admin").describe("Username"),
@@ -149608,6 +150004,20 @@ function coerceNumber(value) {
 	return null;
 }
 /**
+* Baichuan's native PTZ speed scale is 1..63; `runPtz` maps the cap's
+* normalized 0..1 onto it. Named because the autotrack loop has to know the
+* GRANULARITY of the knob it turns -- a normalized 0.37 means something very
+* different on 63 steps than on amcrest's 8.
+*/
+var BAICHUAN_SPEED_STEPS = 63;
+/**
+* How long one `ptz.move` pulse runs, ms -- the `autoStopMs` handed to
+* Baichuan. It is the DENOMINATOR of "how far did the head travel per pulse",
+* so it is exported through `getOptions` rather than left a literal no caller
+* could read.
+*/
+var PTZ_MOVE_IMPULSE_MS = 200;
+/**
 * Per-device transient diagnostics blob populated from the lib's
 * `getOnlineUserSessionsForUi` + `getSocketPoolSummary` +
 * `getSocketPoolCooldownStatus` calls. NOT persisted — recomputed on
@@ -149949,6 +150359,48 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 	* during `adoptDevice`). Standalone cameras default to 0 so the
 	* pre-Hub behavior is preserved verbatim.
 	*/
+	/**
+	* Which preset `goHome` targets, and who decided it.
+	*
+	* Baichuan names no home of its own, so the operator's pick is the only
+	* answer there can be. With none, `none` -- and `goHome` refuses rather than
+	* moving the head to whatever happens to sit in slot 0.
+	*/
+	async resolveHomePreset() {
+		const chosen = this.config.get("homePresetId") ?? "";
+		if (chosen !== "") return {
+			presetId: chosen,
+			source: "operator"
+		};
+		if ((await this.readGuardStatus())?.valid === true) return {
+			presetId: null,
+			source: "native"
+		};
+		return {
+			presetId: null,
+			source: "none"
+		};
+	}
+	/**
+	* The camera's guard-point configuration, or `null` when it cannot be read.
+	*
+	* Never a fabricated "no guard configured": that answer decides whether
+	* `goHome` moves the head, and an unreadable camera is not evidence that no
+	* guard point exists (D393).
+	*/
+	async readGuardStatus() {
+		try {
+			const api = await this.ensureApi();
+			const channel = this.getChannel();
+			return await api.getPtzGuard(channel);
+		} catch (err) {
+			this.ctx.logger.warn("reolink guard point unreadable — goHome will fall back", {
+				tags: { deviceId: this.id },
+				meta: { error: err instanceof Error ? err.message : String(err) }
+			});
+			return null;
+		}
+	}
 	getChannel() {
 		const ch = this.config.get("channel");
 		if (typeof ch === "number" && ch >= 0) return ch;
@@ -153326,7 +153778,9 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 						const channel = this.getChannel();
 						return (await api.getPtzPresets(channel)).map((p) => ({
 							id: String(p.id),
-							name: p.name
+							name: p.name,
+							fn: null,
+							writable: true
 						}));
 					} catch {
 						return [];
@@ -153362,7 +153816,9 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 						hasTilt: false,
 						hasZoom: false,
 						supportsPresets: false,
-						hasAutofocus: false
+						hasAutofocus: false,
+						speedSteps: BAICHUAN_SPEED_STEPS,
+						moveImpulseMs: PTZ_MOVE_IMPULSE_MS
 					};
 					const hasAutofocus = this.config.get("deviceCache")?.autoFocusSnapshot?.supported === true;
 					return this.resolveCapOptions({
@@ -153375,7 +153831,9 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 								hasTilt: capabilities.hasTilt,
 								hasZoom: capabilities.hasZoom,
 								supportsPresets: capabilities.hasPresets,
-								hasAutofocus
+								hasAutofocus,
+								speedSteps: BAICHUAN_SPEED_STEPS,
+								moveImpulseMs: PTZ_MOVE_IMPULSE_MS
 							};
 						},
 						fallback: () => {
@@ -153385,42 +153843,89 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 								hasTilt: hasPtz,
 								hasZoom: hasPtz,
 								supportsPresets: hasPtz,
-								hasAutofocus
+								hasAutofocus,
+								speedSteps: BAICHUAN_SPEED_STEPS,
+								moveImpulseMs: PTZ_MOVE_IMPULSE_MS
 							};
 						}
 					});
 				},
 				goHome: async ({ deviceId }) => {
 					if (deviceId !== this.id) return;
-					try {
-						const api = await this.ensureApi();
-						const channel = this.getChannel();
-						await api.moveToPtzPreset(channel, 0);
-					} catch {}
+					const home = await this.resolveHomePreset();
+					if (home.source === "native") {
+						await (await this.ensureApi()).goToPtzGuard(this.getChannel());
+						return;
+					}
+					if (home.source === "none" || home.presetId === null) throw new Error("No home preset configured for this camera, and it has no guard point set — set one in the PTZ settings, or place a guard point on the camera");
+					const id = Number(home.presetId);
+					if (!Number.isFinite(id)) throw new Error(`Configured home preset is not a Baichuan id: ${home.presetId}`);
+					const api = await this.ensureApi();
+					const channel = this.getChannel();
+					await api.moveToPtzPreset(channel, id);
+				},
+				getHomePreset: async ({ deviceId }) => {
+					if (deviceId !== this.id) return {
+						presetId: null,
+						source: "none"
+					};
+					return this.resolveHomePreset();
+				},
+				captureHomeHere: async ({ deviceId }) => {
+					if (deviceId !== this.id) return;
+					const current = await this.readGuardStatus();
+					const api = await this.ensureApi();
+					const channel = this.getChannel();
+					await api.setPtzGuard({
+						enabled: current?.enabled ?? false,
+						timeoutSeconds: current?.timeoutSeconds ?? 60,
+						setPosition: true
+					}, channel);
+					this.ctx.logger.info("reolink: guard point pinned to the current position", { tags: { deviceId: this.id } });
+				},
+				getHomeReturnSeconds: async ({ deviceId }) => {
+					if (deviceId !== this.id) return null;
+					const guard = await this.readGuardStatus();
+					return guard === null ? null : guard.timeoutSeconds;
+				},
+				setHomeReturnSeconds: async ({ deviceId, seconds }) => {
+					if (deviceId !== this.id) return;
+					const current = await this.readGuardStatus();
+					const api = await this.ensureApi();
+					const channel = this.getChannel();
+					await api.setPtzGuard({
+						enabled: current?.enabled ?? true,
+						timeoutSeconds: seconds,
+						setPosition: false
+					}, channel);
+				},
+				setHomePreset: async ({ deviceId, presetId }) => {
+					if (deviceId !== this.id) return;
+					await this.config.setAll({ homePresetId: presetId ?? "" });
 				},
 				getPosition: async ({ deviceId }) => {
 					if (deviceId !== this.id) return {
-						pan: 0,
-						tilt: 0,
-						zoom: 0
+						pan: null,
+						tilt: null,
+						zoom: null
 					};
 					return {
-						pan: 0,
-						tilt: 0,
-						zoom: 0
+						pan: null,
+						tilt: null,
+						zoom: null
 					};
 				},
 				getStatus: async ({ deviceId }) => {
 					if (deviceId !== this.id) return {
-						pan: 0,
-						tilt: 0,
-						zoom: 0,
+						pan: null,
+						tilt: null,
+						zoom: null,
 						autofocus: false
 					};
 					return {
-						pan: 0,
-						tilt: 0,
-						zoom: 0,
+						pan: null,
+						tilt: null,
+						zoom: null,
 						autofocus: (this.config.get("deviceCache")?.autoFocusSnapshot)?.enabled === true
 					};
 				},
@@ -153471,13 +153976,13 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 		if (tilt !== void 0 && Math.abs(tilt) > .01) cmds.push(tilt > 0 ? "Up" : "Down");
 		if (zoom !== void 0 && Math.abs(zoom) > .01) await this.runZoom(api, channel, zoom);
 		if (cmds.length === 0) return;
-		const baichuanSpeed = speed === void 0 ? 32 : Math.max(1, Math.min(63, Math.round(speed * 63)));
+		const baichuanSpeed = speed === void 0 ? Math.round(BAICHUAN_SPEED_STEPS / 2) : Math.max(1, Math.min(BAICHUAN_SPEED_STEPS, Math.round(speed * BAICHUAN_SPEED_STEPS)));
 		for (const command of cmds) try {
 			await api.ptz(channel, {
 				action: "start",
 				command,
 				speed: baichuanSpeed,
-				...continuous ? {} : { autoStopMs: 200 }
+				...continuous ? {} : { autoStopMs: PTZ_MOVE_IMPULSE_MS }
 			});
 		} catch (err) {
 			this.ctx.logger.warn("Baichuan ptz command failed", {