@camstack/types 1.2.209 → 1.2.211

package/dist/index.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-WeJUxTv-.js");
+const require_sleep = require("./sleep-OPlow2a9.js");
 const require_event_category = require("./event-category-BVfsrBYA.js");
 const require_canonical_hash = require("./canonical-hash-CZ2JqJc3.js");
 const require_enums = require("./enums.js");
@@ -8748,6 +8748,24 @@ var GetStreamWithCodecInputSchema = zod.z.object({
 });
 var RtpSourceSchema = zod.z.object({
 	url: zod.z.string(),
+	/**
+	* The SENTRY counterpart of {@link url} — the dial that asks for the stream
+	* WITHOUT asking for the camera — or `null` when this camera offers none.
+	*
+	* The broker answers it because the broker is the only thing that can:
+	* eligibility is `sentryEligible` (a BATTERY camera that DECLARES the signals
+	* cap), asked of facts only the broker holds. A consumer re-deriving it from
+	* cap bindings would be a second authority, and two authorities on the same
+	* question is how a composite camera ends up dialling a sleeping camera
+	* because its own copy of the rule was a release behind.
+	*
+	* `null` is a real answer and is never a live url in disguise: a consumer
+	* that silently fell back to {@link url} would perform exactly the wake this
+	* field exists to prevent. Only a PASSTHROUGH acquisition can offer one — a
+	* transcode hands back an egress the broker is feeding itself, which has no
+	* sentry counterpart.
+	*/
+	sentryUrl: zod.z.string().nullable().optional(),
 	videoCodec: zod.z.enum(["H264", "H265"]),
 	audioCodec: zod.z.string(),
 	resolution: zod.z.object({
@@ -32420,6 +32438,141 @@ var motionTriggerCapability = {
 	durability: "session"
 };
 //#endregion
+//#region src/capabilities/camera-grid-layout.cap.ts
+/**
+* camera-grid-layout — the geometry of a COMPOSITE camera, on the camera's own
+* page.
+*
+* ## Why this is a capability and not an addon settings schema
+*
+* It was one, and it did not render. The addon declared the editor as a
+* `type: 'widget'` field inside its own `deviceSettingsSchema()`; the hub
+* returned that section correctly and `ConfigFormField` renders `type:'widget'`
+* perfectly well — and nothing ever asked camera-grid for it. The Cluster →
+* Pipeline → Device Overrides page interrogates a HAND-WRITTEN list of four
+* addons (`PIPELINE_CLUSTER_DEVICE_ADDONS`), whose own comment says an addon
+* not on it "falls off silently".
+*
+* Adding a fifth name to that list would have been the wrong fix twice over:
+* that page is per-camera DETECTION tuning, and a grid's geometry belongs
+* beside PTZ and motion zones on the camera itself — which is exactly where the
+* framework already puts a widget, when the widget is declared on a CAPABILITY.
+* `deviceConfig.ui` is the mechanism (`motion-zones`, `ptz`, `ptz-autotrack`
+* all use it): the framework emits the structural section and the widget
+* self-persists through the cap's own mutations.
+*
+* ## Why one addon may implement it
+*
+* It is a device-scoped NATIVE cap, registered by the grid camera device
+* itself. Nothing else declares a composite camera, so nothing else has a
+* layout — and the device-scoped route means the widget asks THE camera, not
+* "the camera-grid addon", which is what let the old custom-action pair be
+* reached only by a caller that already knew the addon id.
+*
+* ## The tab
+*
+* `streaming`, not a top-tab of its own. A grid's geometry IS what its stream
+* is, so the Streaming tab is where it belongs; a `grid` top-tab would need an
+* entry in `WELL_KNOWN_TAB_MAP` or the device page renders the raw id as the
+* label (measured on the robot camera, 2026-09-06 — a tab called "navigation"
+* next to "PTZ").
+*/
+/** A rectangle in normalized [0,1] coordinates of whatever contains it. */
+var GridNormalizedRectSchema = zod.z.object({
+	x: zod.z.number().min(0).max(1),
+	y: zod.z.number().min(0).max(1),
+	width: zod.z.number().gt(0).max(1),
+	height: zod.z.number().gt(0).max(1)
+});
+/**
+* One source camera, the part of its picture taken, and where that part lands.
+*
+* Both rectangles are NORMALIZED (D519): a source camera can change resolution
+* — a profile switch, a firmware update, a substream that comes back different
+* — and a stored PIXEL rectangle would quietly start cutting the wrong region,
+* which is the class of bug nobody files.
+*/
+var GridLayoutCellSchema = zod.z.object({
+	deviceId: zod.z.number().int().positive(),
+	/** The part of the SOURCE taken, normalized against the source. */
+	source: GridNormalizedRectSchema,
+	/** Where it lands, normalized against the CANVAS. */
+	cell: GridNormalizedRectSchema
+});
+/**
+* Which profiles this grid can actually compose, and why not.
+*
+* A grid's `high` composes its sources' `high` and its `low` their `low`, so a
+* profile is on offer only when EVERY source can serve it. The refusal NAMES
+* the sources, because "this grid has no low" is not a finding — "615 has no
+* low" is, and it is the one an operator can act on.
+*/
+var GridProfileOfferSchema = zod.z.object({
+	profile: zod.z.enum([
+		"high",
+		"mid",
+		"low"
+	]),
+	offered: zod.z.boolean(),
+	/** Sources that cannot serve it. Empty when it is offered, or when there are no cells. */
+	missingSources: zod.z.array(zod.z.number().int().positive())
+});
+var GridLayoutViewSchema = zod.z.object({
+	/** The persisted grid row this camera was declared from. */
+	instanceId: zod.z.string(),
+	deviceId: zod.z.number().int().nonnegative(),
+	name: zod.z.string(),
+	/** The canvas the operator laid out — this grid's `high`. mid/low are scaled from it. */
+	width: zod.z.number().int(),
+	height: zod.z.number().int(),
+	fps: zod.z.number().int(),
+	cells: zod.z.array(GridLayoutCellSchema),
+	/** What the catalog will publish, and what it refuses to. Read-only. */
+	profiles: zod.z.array(GridProfileOfferSchema)
+});
+var GridLayoutPatchSchema = zod.z.object({
+	deviceId: zod.z.number().int().nonnegative(),
+	name: zod.z.string().min(1).max(160).optional(),
+	width: zod.z.number().int().min(160).max(7680).optional(),
+	height: zod.z.number().int().min(120).max(4320).optional(),
+	fps: zod.z.number().int().min(1).max(60).optional(),
+	/**
+	* The whole cell list at once. A per-cell patch would need an ordering the
+	* editor does not have, and a half-applied layout is a picture nobody asked
+	* for.
+	*/
+	cells: zod.z.array(GridLayoutCellSchema).max(16)
+});
+var cameraGridLayoutCapability = {
+	name: "camera-grid-layout",
+	scope: "device",
+	deviceNative: true,
+	mode: "singleton",
+	deviceTypes: [require_sleep.DeviceType.Camera],
+	deviceConfig: { ui: {
+		kind: "widget",
+		widgetId: "host/camera-grid-layout",
+		tab: "streaming",
+		label: "Grid layout",
+		order: 20
+	} },
+	methods: {
+		/**
+		* The grid behind this device.
+		*
+		* `null` means ANSWERED and this camera is not a grid — not "not yet
+		* known". The widget renders its "this is not a grid camera" state only
+		* from this answer, never from an unresolved query (D315).
+		*/
+		getLayout: require_sleep.method(zod.z.object({ deviceId: zod.z.number().int().nonnegative() }), GridLayoutViewSchema.nullable(), { auth: "admin" }),
+		/** Write the geometry back. Returns the grid as it now stands, profiles included. */
+		saveLayout: require_sleep.method(GridLayoutPatchSchema, GridLayoutViewSchema, {
+			kind: "mutation",
+			auth: "admin"
+		})
+	}
+};
+//#endregion
 //#region src/capabilities/motion-zones.cap.ts
 /**
 * Motion-zones share the same MaskShape vocabulary as privacy-mask — the
@@ -35038,6 +35191,26 @@ var PtzHomePresetSchema = zod.z.object({
 		"none"
 	])
 });
+/**
+* The camera's own idle-return behaviour: whether it goes home by itself, and
+* after how long.
+*
+* ONE shape, not two scalars, because on the camera they are ONE fact —
+* Reolink's guard point carries `benable` and `timeout` in the same element,
+* written by the same command. Reading them apart means two round-trips that
+* can disagree.
+*
+* `enabled` and `seconds` are INDEPENDENT: a camera can hold a 68 s delay with
+* the behaviour switched off, which is exactly what the vendor app leaves when
+* you turn the guard point off without clearing it. The first version of this
+* cap reported only the delay, so that state was invisible — a camera could be
+* configured to return after 68 seconds with no way to say whether it should
+* return at all.
+*/
+var PtzHomeReturnSchema = zod.z.object({
+	enabled: zod.z.boolean(),
+	seconds: zod.z.number().int()
+});
 var ptzCapability = {
 	name: "ptz",
 	scope: "device",
@@ -35120,18 +35293,25 @@ var ptzCapability = {
 			auth: "admin"
 		}),
 		/**
-		* How long the camera waits, idle, before returning home on its own --
-		* `null` when it has no such behaviour.
+		* Whether the camera returns home on its own when left idle, and after how
+		* long. `null` when it has no such behaviour at all.
 		*
 		* 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: require_sleep.method(zod.z.object({ deviceId: zod.z.number() }), zod.z.number().int().nullable()),
-		/** Set the idle-return delay. Refused by a camera that has no such timer. */
-		setHomeReturnSeconds: require_sleep.method(zod.z.object({
+		getHomeReturn: require_sleep.method(zod.z.object({ deviceId: zod.z.number() }), PtzHomeReturnSchema.nullable()),
+		/**
+		* Set both together. Refused by a camera with no idle-return behaviour.
+		*
+		* They travel together for the same reason they are read together: the
+		* underlying write carries both, so setting one alone means reading the
+		* other back first and racing whoever else is writing.
+		*/
+		setHomeReturn: require_sleep.method(zod.z.object({
 			deviceId: zod.z.number(),
+			enabled: zod.z.boolean(),
 			seconds: zod.z.number().int().min(0).max(3600)
 		}), zod.z.void(), {
 			kind: "mutation",
@@ -43025,6 +43205,7 @@ var CAPABILITY_NAMES = {
 	broker: "broker",
 	button: "button",
 	cameraCredentials: "camera-credentials",
+	cameraGridLayout: "camera-grid-layout",
 	cameraPipelineConfig: "camera-pipeline-config",
 	cameraStreams: "camera-streams",
 	carbonMonoxide: "carbon-monoxide",
@@ -43263,6 +43444,10 @@ var CAPABILITY_ROUTER_KEYS = [
 		key: "cameraCredentials",
 		name: "camera-credentials"
 	},
+	{
+		key: "cameraGridLayout",
+		name: "camera-grid-layout"
+	},
 	{
 		key: "cameraPipelineConfig",
 		name: "camera-pipeline-config"
@@ -43824,6 +44009,7 @@ var ALL_CAPABILITY_DEFINITIONS = [
 	brokerCapability,
 	buttonCapability,
 	cameraCredentialsCapability,
+	cameraGridLayoutCapability,
 	cameraPipelineConfigCapability,
 	cameraStreamsCapability,
 	carbonMonoxideCapability,
@@ -44679,6 +44865,18 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"cameraGridLayout.getLayout": {
+		capName: "camera-grid-layout",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
+	"cameraGridLayout.saveLayout": {
+		capName: "camera-grid-layout",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"cameraStreams.getBrokerStreams": {
 		capName: "camera-streams",
 		capScope: "device",
@@ -48429,7 +48627,7 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
-	"ptz.getHomeReturnSeconds": {
+	"ptz.getHomeReturn": {
 		capName: "ptz",
 		capScope: "device",
 		addonId: null,
@@ -48489,7 +48687,7 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
-	"ptz.setHomeReturnSeconds": {
+	"ptz.setHomeReturn": {
 		capName: "ptz",
 		capScope: "device",
 		addonId: null,
@@ -50303,6 +50501,7 @@ var KNOWN_CAP_NAMES = [
 	"broker",
 	"button",
 	"camera-credentials",
+	"camera-grid-layout",
 	"camera-streams",
 	"climate-control",
 	"color",
@@ -50422,6 +50621,7 @@ var DEVICE_CAP_NAMES = [
 	"brightness",
 	"button",
 	"camera-credentials",
+	"camera-grid-layout",
 	"camera-streams",
 	"climate-control",
 	"color",
@@ -50649,6 +50849,21 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"cameraGridLayout.getLayout": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"cameraGridLayout.saveLayout": [{
+		name: "cells",
+		form: "object-array",
+		optional: false,
+		itemField: "deviceId"
+	}, {
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"cameraStreams.getBrokerStreams": [{
 		name: "deviceId",
 		form: "single",
@@ -51949,7 +52164,7 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 		form: "single",
 		optional: false
 	}],
-	"ptz.getHomeReturnSeconds": [{
+	"ptz.getHomeReturn": [{
 		name: "deviceId",
 		form: "single",
 		optional: false
@@ -51999,7 +52214,7 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 		form: "single",
 		optional: false
 	}],
-	"ptz.setHomeReturnSeconds": [{
+	"ptz.setHomeReturn": [{
 		name: "deviceId",
 		form: "single",
 		optional: false
@@ -58240,6 +58455,8 @@ exports.GasStatusSchema = GasStatusSchema;
 exports.GetLoggingSettingsInputSchema = GetLoggingSettingsInputSchema;
 exports.GetStreamWithCodecInputSchema = GetStreamWithCodecInputSchema;
 exports.GlobalMetricsSchema = GlobalMetricsSchema;
+exports.GridLayoutPatchSchema = GridLayoutPatchSchema;
+exports.GridLayoutViewSchema = GridLayoutViewSchema;
 exports.HAP_AUDIO_BASE = HAP_AUDIO_BASE;
 exports.HAP_AUDIO_BITRATE_KBPS = HAP_AUDIO_BITRATE_KBPS;
 exports.HAP_AUDIO_VBV_KBITS = HAP_AUDIO_VBV_KBITS;
@@ -58631,6 +58848,7 @@ exports.PtzAutotrackSettingsSchema = PtzAutotrackSettingsSchema;
 exports.PtzAutotrackStatusSchema = PtzAutotrackStatusSchema;
 exports.PtzAutotrackTargetOptionSchema = PtzAutotrackTargetOptionSchema;
 exports.PtzHomePresetSchema = PtzHomePresetSchema;
+exports.PtzHomeReturnSchema = PtzHomeReturnSchema;
 exports.PtzMoveCommandSchema = PtzMoveCommandSchema;
 exports.PtzOptionsSchema = PtzOptionsSchema;
 exports.PtzPositionSchema = PtzPositionSchema;
@@ -59033,6 +59251,7 @@ exports.buildStreamParamsConfigSchema = buildStreamParamsConfigSchema;
 exports.buildVideoArgs = require_canonical_hash.buildVideoArgs;
 exports.buttonCapability = buttonCapability;
 exports.cameraCredentialsCapability = cameraCredentialsCapability;
+exports.cameraGridLayoutCapability = cameraGridLayoutCapability;
 exports.cameraPipelineConfigCapability = cameraPipelineConfigCapability;
 exports.cameraStreamsCapability = cameraStreamsCapability;
 exports.canConvertUnit = canConvertUnit;