@camstack/types 1.2.210 → 1.2.212

package/dist/index.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-CDG4jaLR.js");
+const require_sleep = require("./sleep-VlZxDyXq.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,156 @@ 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. The device page is
+* BINDING-driven (D12), so the way in is a capability bound to the device —
+* and this cap carries its section the way `recording` does, by RETURNING it
+* from `getDeviceSettingsContribution`.
+*
+* Seven other widgets are still declared the other way, through a
+* `deviceConfig.ui` block the framework derives a section from. That route
+* gives the addon no say in where its own panel lands and no way to decline
+* for a device the panel does not suit, which is why this one does not use it.
+*
+* ## 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],
+	/**
+	* The section is built by the ADDON and returned from
+	* `getDeviceSettingsContribution`, not derived by the framework from a
+	* `deviceConfig.ui` block.
+	*
+	* Both mechanisms render the same widget. This one hands the addon two
+	* things the framework-derived route cannot give it:
+	*
+	*  - it chooses its own section, `tab`, `location` and `order`, the way any
+	*    other setting does, instead of receiving them from a cap declaration;
+	*  - it can DECLINE per device. A camera that is not a grid gets no section
+	*    at all, rather than a widget that renders its own "not a grid" state.
+	*
+	* `recording` is the precedent (`recorder/recording-device-settings.ts`): it
+	* returns `null` for anything that is not a camera, so the Recording tab
+	* never appears there.
+	*/
+	exposesDeviceSettings: true,
+	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
@@ -43052,6 +43220,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",
@@ -43290,6 +43459,10 @@ var CAPABILITY_ROUTER_KEYS = [
 		key: "cameraCredentials",
 		name: "camera-credentials"
 	},
+	{
+		key: "cameraGridLayout",
+		name: "camera-grid-layout"
+	},
 	{
 		key: "cameraPipelineConfig",
 		name: "camera-pipeline-config"
@@ -43851,6 +44024,7 @@ var ALL_CAPABILITY_DEFINITIONS = [
 	brokerCapability,
 	buttonCapability,
 	cameraCredentialsCapability,
+	cameraGridLayoutCapability,
 	cameraPipelineConfigCapability,
 	cameraStreamsCapability,
 	carbonMonoxideCapability,
@@ -44706,6 +44880,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",
@@ -50330,6 +50516,7 @@ var KNOWN_CAP_NAMES = [
 	"broker",
 	"button",
 	"camera-credentials",
+	"camera-grid-layout",
 	"camera-streams",
 	"climate-control",
 	"color",
@@ -50449,6 +50636,7 @@ var DEVICE_CAP_NAMES = [
 	"brightness",
 	"button",
 	"camera-credentials",
+	"camera-grid-layout",
 	"camera-streams",
 	"climate-control",
 	"color",
@@ -50676,6 +50864,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",
@@ -58267,6 +58470,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;
@@ -59061,6 +59266,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;