@camstack/addon-provider-amcrest 0.2.113 → 0.2.114

package/dist/addon.js

@@ -5367,7 +5367,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-B1y0Fo1U.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).
@@ -31281,6 +31281,47 @@ var ptzCapability = {
 			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
 		* haven't migrated. Will be folded into `getStatus` in a future
@@ -40941,6 +40982,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"ptz.captureHomeHere": {
+		capName: "ptz",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"ptz.continuousMove": {
 		capName: "ptz",
 		capScope: "device",
@@ -40959,6 +41006,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"ptz.getHomeReturnSeconds": {
+		capName: "ptz",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"ptz.getOptions": {
 		capName: "ptz",
 		capScope: "device",
@@ -41013,6 +41066,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"ptz.setHomeReturnSeconds": {
+		capName: "ptz",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"ptz.stop": {
 		capName: "ptz",
 		capScope: "device",
@@ -44176,6 +44235,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"ptz.captureHomeHere": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"ptz.continuousMove": [{
 		name: "deviceId",
 		form: "single",
@@ -44191,6 +44255,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"ptz.getHomeReturnSeconds": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"ptz.getOptions": [{
 		name: "deviceId",
 		form: "single",
@@ -44236,6 +44305,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"ptz.setHomeReturnSeconds": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"ptz.stop": [{
 		name: "deviceId",
 		form: "single",
@@ -46959,6 +47033,8 @@ var AmcrestCamera = class AmcrestCamera extends BaseDevice {
 	* granularity is reported through `getOptions` instead of being hidden
 	* behind a 0..1 float.
 	*/
+	/** Dahua exposes 25 fixed preset slots, 1-based. */
+	static DAHUA_MAX_PRESETS = 25;
 	static DAHUA_SPEED_STEPS = 8;
 	/**
 	* How long one `ptz.move` pulse runs, ms. The DENOMINATOR of "how far did
@@ -47162,6 +47238,27 @@ var AmcrestCamera = class AmcrestCamera extends BaseDevice {
 				};
 				return this.resolveHomePreset();
 			},
+			captureHomeHere: async ({ deviceId }) => {
+				if (deviceId !== this.id) return;
+				const client = this.ensureClient();
+				const ceiling = (await client.getPtzCaps(this.channel))?.maxPresets ?? AmcrestCamera.DAHUA_MAX_PRESETS;
+				const used = new Set((await client.getPtzPresets(this.channel)).map((p) => p.id));
+				let slot = 1;
+				while (used.has(slot) && slot <= ceiling) slot += 1;
+				if (slot > ceiling) throw new Error("No free preset slot on this camera to store a home position — free one first");
+				await client.ptzSetPreset(this.channel, slot, AmcrestCamera.PTZ_CGI_TIMEOUT_MS);
+				await this.config.setAll({ homePresetId: String(slot) });
+				this.ctx.logger.info("amcrest: home pinned to the current position", {
+					tags: { deviceId: this.id },
+					meta: { presetId: slot }
+				});
+			},
+			getHomeReturnSeconds: async () => {
+				return null;
+			},
+			setHomeReturnSeconds: async () => {
+				throw new Error("Amcrest: the idle-return timer is not wired on this driver");
+			},
 			setHomePreset: async ({ deviceId, presetId }) => {
 				if (deviceId !== this.id) return;
 				await this.config.setAll({ homePresetId: presetId ?? "" });

package/dist/addon.mjs

@@ -5368,7 +5368,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-B1y0Fo1U.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).
@@ -31282,6 +31282,47 @@ var ptzCapability = {
 			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
 		* haven't migrated. Will be folded into `getStatus` in a future
@@ -40942,6 +40983,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"ptz.captureHomeHere": {
+		capName: "ptz",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"ptz.continuousMove": {
 		capName: "ptz",
 		capScope: "device",
@@ -40960,6 +41007,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"ptz.getHomeReturnSeconds": {
+		capName: "ptz",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"ptz.getOptions": {
 		capName: "ptz",
 		capScope: "device",
@@ -41014,6 +41067,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"ptz.setHomeReturnSeconds": {
+		capName: "ptz",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"ptz.stop": {
 		capName: "ptz",
 		capScope: "device",
@@ -44177,6 +44236,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"ptz.captureHomeHere": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"ptz.continuousMove": [{
 		name: "deviceId",
 		form: "single",
@@ -44192,6 +44256,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"ptz.getHomeReturnSeconds": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"ptz.getOptions": [{
 		name: "deviceId",
 		form: "single",
@@ -44237,6 +44306,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"ptz.setHomeReturnSeconds": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"ptz.stop": [{
 		name: "deviceId",
 		form: "single",
@@ -46960,6 +47034,8 @@ var AmcrestCamera = class AmcrestCamera extends BaseDevice {
 	* granularity is reported through `getOptions` instead of being hidden
 	* behind a 0..1 float.
 	*/
+	/** Dahua exposes 25 fixed preset slots, 1-based. */
+	static DAHUA_MAX_PRESETS = 25;
 	static DAHUA_SPEED_STEPS = 8;
 	/**
 	* How long one `ptz.move` pulse runs, ms. The DENOMINATOR of "how far did
@@ -47163,6 +47239,27 @@ var AmcrestCamera = class AmcrestCamera extends BaseDevice {
 				};
 				return this.resolveHomePreset();
 			},
+			captureHomeHere: async ({ deviceId }) => {
+				if (deviceId !== this.id) return;
+				const client = this.ensureClient();
+				const ceiling = (await client.getPtzCaps(this.channel))?.maxPresets ?? AmcrestCamera.DAHUA_MAX_PRESETS;
+				const used = new Set((await client.getPtzPresets(this.channel)).map((p) => p.id));
+				let slot = 1;
+				while (used.has(slot) && slot <= ceiling) slot += 1;
+				if (slot > ceiling) throw new Error("No free preset slot on this camera to store a home position — free one first");
+				await client.ptzSetPreset(this.channel, slot, AmcrestCamera.PTZ_CGI_TIMEOUT_MS);
+				await this.config.setAll({ homePresetId: String(slot) });
+				this.ctx.logger.info("amcrest: home pinned to the current position", {
+					tags: { deviceId: this.id },
+					meta: { presetId: slot }
+				});
+			},
+			getHomeReturnSeconds: async () => {
+				return null;
+			},
+			setHomeReturnSeconds: async () => {
+				throw new Error("Amcrest: the idle-return timer is not wired on this driver");
+			},
 			setHomePreset: async ({ deviceId, presetId }) => {
 				if (deviceId !== this.id) return;
 				await this.config.setAll({ homePresetId: presetId ?? "" });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-amcrest",
-  "version": "0.2.113",
+  "version": "0.2.114",
   "description": "Amcrest/Dahua camera device provider addon for CamStack — Dahua CGI over HTTP(S) with digest auth (snapshot, RTSP catalog, PTZ, image/day-night config)",
   "keywords": [
     "camstack",