@camstack/system 1.2.243 → 1.2.245

package/dist/{dist-D6kqBW1G.js → dist-Cz6h6Nc3.js}

@@ -11433,6 +11433,81 @@ var LocationIconAssignmentSchema = zod.z.object({
 function locationIconKey(label) {
 	return label.trim().toLowerCase();
 }
+/**
+* One (location, description) assignment as it travels.
+*
+* Same key discipline as {@link LocationIconAssignmentSchema}, and for the same
+* reason: this lived for a while in the post-analysis addon's own settings,
+* keyed by a HAND-TYPED label matched exactly and case-sensitively. A rename in
+* the Locations page carried the icon and silently orphaned the description —
+* two authorities for one thing, joined by two different rules. Now both hang
+* off the location itself, on `locationIconKey`.
+*/
+var LocationDescriptionAssignmentSchema = zod.z.object({
+	locationKey: zod.z.string(),
+	description: zod.z.string()
+});
+/**
+* A SITE ZONE — a named part of the property that several locations belong to.
+*
+* "Zona notte" holds every bedroom; "Zona giorno" the living room and the
+* kitchen. A camera belongs to exactly one location, and a location to at most
+* one zone, so a camera's zone is derived and never stored on the device: the
+* whole point of this entity is that grouping rooms touches no device row.
+*
+* ## Why not `zone`
+*
+* Because `zone` is already the most loaded word in this product: 612 source
+* files and 24 Italian strings where it means a DETECTION zone drawn on a
+* camera. The two are unrelated — one is a polygon in a frame, the other is a
+* set of rooms — and a reader who confuses them will look for a camera's
+* bedrooms. So the code says `siteZone` everywhere, and the UI frees the plain
+* word by calling the drawn one what it actually is: a detection zone.
+*
+* ## The key
+*
+* `siteZoneKey(label)` — trimmed, lower-cased, the SAME derivation locations
+* use (`locationIconKey`). Membership and the icon both hang off it, so a
+* case-only rename keeps them, which is exactly the orphaning that cost us a
+* silently-dropped location description.
+*
+* The icon vocabulary is the location one, unchanged: a zone is drawn on the
+* same two surfaces by the same glyph map, so a second vocabulary would be a
+* second thing to keep drawable (`scripts/check-location-icons-drawable.ts`).
+*/
+/**
+* One zone as it travels: its key, the label the operator typed, its icon and
+* the locations inside it.
+*
+* The LABEL is carried alongside the key because the key is lossy on purpose —
+* a surface must show "Zona notte", not "zona notte". Locations are carried
+* here, rather than left to a second call, because every consumer wants both
+* at once and a viewer that asked twice could render a zone whose membership
+* it has not fetched yet.
+*
+* `icon: null` means nobody chose one, which is NOT the fallback pin: only one
+* of those two is a choice, and a picker has to draw them differently.
+*/
+var SiteZoneSchema = zod.z.object({
+	zoneKey: zod.z.string(),
+	label: zod.z.string(),
+	icon: LocationIconIdSchema.nullable(),
+	/** Folded location keys, sorted. A location listed here need not be
+	*  REGISTERED — devices carry labels nobody registered, and those rooms are
+	*  the ones that most want grouping. */
+	locationKeys: zod.z.array(zod.z.string())
+});
+/**
+* The join key for a zone label: trimmed, lower-cased.
+*
+* Deliberately a separate export from `locationIconKey` even though the
+* derivation is identical — they key different maps, and a future change to one
+* must not silently re-key the other. Their agreement is a fact about today,
+* not a dependency.
+*/
+function siteZoneKey(label) {
+	return label.trim().toLowerCase();
+}
 var ProviderStatusSchema = zod.z.object({
 	connected: zod.z.boolean(),
 	deviceCount: zod.z.number(),
@@ -12233,6 +12308,94 @@ var deviceManagerCapability = {
 			kind: "mutation",
 			auth: "admin"
 		}),
+		/** Every location that carries a DESCRIPTION — what the place LOOKS like,
+		*  in plain words, given to the vision model alongside the pictures so it
+		*  knows what it is looking at. A driveway of cobbles between a brick wall
+		*  and three parking spaces reads very differently from a back garden.
+		*
+		*  Same additive shape and same join key as `listLocationIcons`, and that
+		*  is the point of it being here at all: this lived in the post-analysis
+		*  addon's own settings, keyed by a hand-typed label matched exactly and
+		*  case-sensitively, while the icon hung off the location itself. A rename
+		*  carried the icon and silently orphaned the description. One location,
+		*  one authority, one key.
+		*
+		*  Absent means nobody wrote one — the digest then tells the model only the
+		*  location NAME, exactly as it did before descriptions existed. */
+		listLocationDescriptions: method(zod.z.void(), zod.z.array(LocationDescriptionAssignmentSchema)),
+		/** Set (or clear) a location's description. `description: null`, or a
+		*  blank string, removes it — an empty description and no description are
+		*  the same thing to every reader, and storing the first would send an
+		*  empty line to the model.
+		*
+		*  Like `setLocationIcon`, the label need NOT be registered, and an
+		*  empty / whitespace-only LABEL throws. */
+		setLocationDescription: method(zod.z.object({
+			location: zod.z.string(),
+			description: zod.z.string().max(400).nullable()
+		}), zod.z.void(), {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/** Every SITE ZONE — a named part of the property that groups locations
+		*  ("Zona notte" holds the bedrooms). One call answers the whole picture:
+		*  key, the label as typed, the icon, and the locations inside.
+		*
+		*  Together, because a surface that asked for membership separately could
+		*  draw a zone whose rooms it has not fetched — and the strip that renders
+		*  these puts zones BEFORE locations, so a half-known zone is the first
+		*  thing an operator sees.
+		*
+		*  Nothing here touches a device: a camera's zone is derived from its
+		*  location, never stored on the row. Grouping rooms must not rewrite the
+		*  fleet. */
+		listSiteZones: method(zod.z.void(), zod.z.array(SiteZoneSchema)),
+		/** Create a zone, or set the icon of one that exists. `icon: null` clears
+		*  the icon and KEEPS the zone — a zone with no icon is a normal zone, and
+		*  conflating "no icon" with "no zone" would delete membership on a
+		*  mis-click.
+		*
+		*  Idempotent, and the label is stored as typed: the key is folded, so
+		*  re-running this with different casing re-labels rather than duplicating. */
+		setSiteZone: method(zod.z.object({
+			name: zod.z.string(),
+			icon: LocationIconIdSchema.nullable().optional()
+		}), zod.z.void(), {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/** Delete a zone. Its LOCATIONS survive — they simply stop belonging to
+		*  anything. Deleting a grouping must never delete what was grouped. */
+		removeSiteZone: method(zod.z.object({ name: zod.z.string() }), zod.z.void(), {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/** Rename a zone, carrying its icon AND its membership.
+		*
+		*  It exists so that renaming is not delete-then-recreate, which would drop
+		*  both — the exact orphaning that lost a location's description when the
+		*  two hung off different keys. Renaming onto an existing zone MERGES into
+		*  it and the target keeps its own icon. */
+		renameSiteZone: method(zod.z.object({
+			from: zod.z.string(),
+			to: zod.z.string()
+		}), zod.z.void(), {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/** Put a location in a zone, or take it out with `zone: null`.
+		*
+		*  At most one zone per location, by construction: this writes one key, so
+		*  there is no state in which a room is in two places at once. The zone
+		*  need not exist yet — it is created empty-labelled from this call, the
+		*  same way `setLocationIcon` does not require a registered location. */
+		setLocationZone: method(zod.z.object({
+			location: zod.z.string(),
+			zone: zod.z.string().nullable()
+		}), zod.z.void(), {
+			kind: "mutation",
+			auth: "admin"
+		}),
 		/** Soft-disable / re-enable the device. Drivers consult
 		*  `BaseDevice.disabled` to gate lifecycle hooks. */
 		setDisabled: method(zod.z.object({
@@ -39056,6 +39219,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"deviceManager.listLocationDescriptions": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.listLocationIcons": {
 		capName: "device-manager",
 		capScope: "system",
@@ -39074,6 +39243,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"deviceManager.listSiteZones": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.listWrappersForCap": {
 		capName: "device-manager",
 		capScope: "system",
@@ -39158,12 +39333,24 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "delete"
 	},
+	"deviceManager.removeSiteZone": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "delete"
+	},
 	"deviceManager.renameLocation": {
 		capName: "device-manager",
 		capScope: "system",
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.renameSiteZone": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"deviceManager.runDeviceAction": {
 		capName: "device-manager",
 		capScope: "system",
@@ -39206,12 +39393,24 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.setLocationDescription": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"deviceManager.setLocationIcon": {
 		capName: "device-manager",
 		capScope: "system",
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.setLocationZone": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"deviceManager.setMetadata": {
 		capName: "device-manager",
 		capScope: "system",
@@ -39242,6 +39441,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.setSiteZone": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"deviceManager.setStreamProfileMap": {
 		capName: "device-manager",
 		capScope: "system",
@@ -47487,6 +47692,12 @@ Object.defineProperty(exports, "settingsStoreCapability", {
 		return settingsStoreCapability;
 	}
 });
+Object.defineProperty(exports, "siteZoneKey", {
+	enumerable: true,
+	get: function() {
+		return siteZoneKey;
+	}
+});
 Object.defineProperty(exports, "sleep", {
 	enumerable: true,
 	get: function() {

package/dist/index.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_dist = require("./dist-D6kqBW1G.js");
+const require_dist = require("./dist-Cz6h6Nc3.js");
 const require_builtins_alerts_alerts_addon = require("./builtins/alerts/alerts.addon.js");
 require("./builtins/alerts/index.js");
 const require_formatter = require("./formatter-DqAKDlvN.js");

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { a as __toCommonJS, i as __require, n as __esmMin, o as __toESM$1, r as __exportAll, t as __commonJSMin$1 } from "./chunk-CNf5ZN-e.mjs";
-import { $t as DEVICE_STATUS_METHOD, Ft as scopesAllowAddon, It as scopesAllowDeviceCap, Nt as resolveMethodAuth, Ot as procedureAuthKey, Qt as DEVICE_SETTINGS_CONTRIBUTION_METHODS, Sn as EventCategory$1, Tt as objectInputDeclaresAddonId, Yt as errMsg$1, Zt as DATAPLANE_SECRET_HEADER$1, _n as parseJsonUnknown, at as isArrayOutputSchema, bn as scopeKey, cn as asString$1, ct as isObjectInput, dt as isVoidInput, fn as expandCapMethods, ft as kebabToCamel, g as METHOD_ACCESS_MAP, gn as parseJsonObject, in as ReadinessTimeoutError, j as addonSettingsCapability, ln as createEvent, mt as lifecycleJobSchema, on as asJsonObject$1, ot as isCollectionArrayMethod, p as LOG_LEVEL_RANK, rn as ReadinessRegistry, sn as asNumber, t as ALL_CAPABILITY_DEFINITIONS, tt as extractNestedAddonId, un as emitDownForOwnedCaps, v as RUNTIME_DEFAULTS, vn as readinessKey, vt as logLevelAtMost, yn as resolveCapMount, yt as looseSchema } from "./dist-B4htkDVv.mjs";
+import { $t as DEVICE_SETTINGS_CONTRIBUTION_METHODS, Cn as EventCategory$1, Ft as scopesAllowAddon, It as scopesAllowDeviceCap, Nt as resolveMethodAuth, Ot as procedureAuthKey, Qt as DATAPLANE_SECRET_HEADER$1, Tt as objectInputDeclaresAddonId, Xt as errMsg$1, _n as parseJsonObject, an as ReadinessTimeoutError, at as isArrayOutputSchema, bn as resolveCapMount, cn as asNumber, ct as isObjectInput, dn as emitDownForOwnedCaps, dt as isVoidInput, en as DEVICE_STATUS_METHOD, ft as kebabToCamel, g as METHOD_ACCESS_MAP, in as ReadinessRegistry, j as addonSettingsCapability, ln as asString$1, mt as lifecycleJobSchema, ot as isCollectionArrayMethod, p as LOG_LEVEL_RANK, pn as expandCapMethods, sn as asJsonObject$1, t as ALL_CAPABILITY_DEFINITIONS, tt as extractNestedAddonId, un as createEvent, v as RUNTIME_DEFAULTS, vn as parseJsonUnknown, vt as logLevelAtMost, xn as scopeKey, yn as readinessKey, yt as looseSchema } from "./dist-4MS1GNc8.mjs";
 import { AlertCenterAddon } from "./builtins/alerts/alerts.addon.mjs";
 import "./builtins/alerts/index.mjs";
 import { t as formatLogLine } from "./formatter-B7qW8bPJ.mjs";

package/dist/{retired-settings-keys-BPIyHR4_.js → retired-settings-keys-DBrIdOQp.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-D6kqBW1G.js");
+const require_dist = require("./dist-Cz6h6Nc3.js");
 //#region src/builtins/sqlite-storage/retired-settings-keys.ts
 /**
 * Is THIS node the one whose settings store is the cluster's authority?

package/dist/{retired-settings-keys-C9w4b4TV.mjs → retired-settings-keys-D_5MkKII.mjs}

@@ -1,4 +1,4 @@
-import { on as asJsonObject } from "./dist-B4htkDVv.mjs";
+import { sn as asJsonObject } from "./dist-4MS1GNc8.mjs";
 //#region src/builtins/sqlite-storage/retired-settings-keys.ts
 /**
 * Is THIS node the one whose settings store is the cluster's authority?

package/dist/{snapshot-courtesy-LoJNgHHZ.mjs → snapshot-courtesy-CZPvteq2.mjs}

@@ -76,26 +76,53 @@ function escapeCourtesyText(value) {
 * frame read the same, with a floor so a thumbnail stays legible.
 */
 function buildCourtesySvg(spec) {
-	return buildStateSvg(spec, false);
+	return buildStateSvg(spec);
 }
 /**
-* The same state treatment as a courtesy frame, but translucent so the last
-* real camera frame remains visible underneath it.
+* The state treatment for a frame that HAS a picture under it: a band along the
+* bottom, and nothing else touched.
+*
+* It was a full-frame wash at 0.62 opacity, under a docblock claiming the frame
+* "remains visible underneath". A 38 % view of a dark room is not a view of it,
+* and the operator read the result as a placeholder rather than as their own
+* camera: *"ma perché Waking? Dovremmo mostrare l'ultimo snapshot
+* disponibile"* (Baby monitor, 2026-09-16).
+*
+* The marker still has to earn its place — a stale frame shown clean gets
+* mistaken for live, which is the reason the treatment exists at all. A band
+* says the same thing a wash said. Covering the picture was never the message.
 */
 function buildCourtesyOverlaySvg(spec) {
-	return buildStateSvg(spec, true);
+	const state = escapeCourtesyText(courtesyLabel(spec.reason));
+	const name = escapeCourtesyText(spec.deviceName);
+	const stateSize = Math.max(11, Math.round(spec.width / 34));
+	const bandHeight = Math.max(26, Math.round(stateSize * 2.2));
+	const bandTop = Math.max(0, spec.height - bandHeight);
+	const baselineY = Math.round(bandTop + bandHeight * .68);
+	const textStroke = Math.max(1, Math.round(spec.width / 320));
+	return [
+		`<svg xmlns="http://www.w3.org/2000/svg" width="${String(spec.width)}" height="${String(spec.height)}">`,
+		`<rect x="0" y="${String(bandTop)}" width="${String(spec.width)}" height="${String(bandHeight)}" fill="${courtesyBackground(spec.reason)}" fill-opacity="0.82"/>`,
+		`<g font-family="${COURTESY_FONT_STACK}" text-anchor="middle" paint-order="stroke" stroke="#111118" stroke-width="${String(textStroke)}">`,
+		`<text x="50%" y="${String(baselineY)}" font-size="${String(stateSize)}" fill="#e8e8ee">${state}`,
+		`<tspan fill="#9a9aa8"> · ${name}</tspan>`,
+		`</text></g></svg>`
+	].join("");
 }
-function buildStateSvg(spec, overlay) {
+/**
+* The GENERATED card: no picture exists, so this IS the picture. Opaque by
+* necessity — anything translucent here shows black through it.
+*/
+function buildStateSvg(spec) {
 	const stateSize = Math.max(12, Math.round(spec.width / 12));
 	const nameSize = Math.max(9, Math.round(spec.width / 26));
 	const state = escapeCourtesyText(courtesyLabel(spec.reason));
 	const name = escapeCourtesyText(spec.deviceName);
 	const midY = spec.height / 2;
-	const washOpacity = overlay ? "0.62" : "1";
 	const textStroke = Math.max(1, Math.round(spec.width / 320));
 	return [
 		`<svg xmlns="http://www.w3.org/2000/svg" width="${String(spec.width)}" height="${String(spec.height)}">`,
-		`<rect width="100%" height="100%" fill="${courtesyBackground(spec.reason)}" fill-opacity="${washOpacity}"/>`,
+		`<rect width="100%" height="100%" fill="${courtesyBackground(spec.reason)}" fill-opacity="1"/>`,
 		`<g font-family="${COURTESY_FONT_STACK}" text-anchor="middle" paint-order="stroke" stroke="#111118" stroke-width="${String(textStroke)}">`,
 		`<text x="50%" y="${String(Math.round(midY))}" font-size="${String(stateSize)}" fill="#e8e8ee">${state}</text>`,
 		`<text x="50%" y="${String(Math.round(midY + stateSize))}" font-size="${String(nameSize)}" fill="#9a9aa8">${name}</text>`,

package/dist/{snapshot-courtesy-oeTWCXPv.js → snapshot-courtesy-Cqs7GkOV.js}

@@ -78,26 +78,53 @@ function escapeCourtesyText(value) {
 * frame read the same, with a floor so a thumbnail stays legible.
 */
 function buildCourtesySvg(spec) {
-	return buildStateSvg(spec, false);
+	return buildStateSvg(spec);
 }
 /**
-* The same state treatment as a courtesy frame, but translucent so the last
-* real camera frame remains visible underneath it.
+* The state treatment for a frame that HAS a picture under it: a band along the
+* bottom, and nothing else touched.
+*
+* It was a full-frame wash at 0.62 opacity, under a docblock claiming the frame
+* "remains visible underneath". A 38 % view of a dark room is not a view of it,
+* and the operator read the result as a placeholder rather than as their own
+* camera: *"ma perché Waking? Dovremmo mostrare l'ultimo snapshot
+* disponibile"* (Baby monitor, 2026-09-16).
+*
+* The marker still has to earn its place — a stale frame shown clean gets
+* mistaken for live, which is the reason the treatment exists at all. A band
+* says the same thing a wash said. Covering the picture was never the message.
 */
 function buildCourtesyOverlaySvg(spec) {
-	return buildStateSvg(spec, true);
+	const state = escapeCourtesyText(courtesyLabel(spec.reason));
+	const name = escapeCourtesyText(spec.deviceName);
+	const stateSize = Math.max(11, Math.round(spec.width / 34));
+	const bandHeight = Math.max(26, Math.round(stateSize * 2.2));
+	const bandTop = Math.max(0, spec.height - bandHeight);
+	const baselineY = Math.round(bandTop + bandHeight * .68);
+	const textStroke = Math.max(1, Math.round(spec.width / 320));
+	return [
+		`<svg xmlns="http://www.w3.org/2000/svg" width="${String(spec.width)}" height="${String(spec.height)}">`,
+		`<rect x="0" y="${String(bandTop)}" width="${String(spec.width)}" height="${String(bandHeight)}" fill="${courtesyBackground(spec.reason)}" fill-opacity="0.82"/>`,
+		`<g font-family="${COURTESY_FONT_STACK}" text-anchor="middle" paint-order="stroke" stroke="#111118" stroke-width="${String(textStroke)}">`,
+		`<text x="50%" y="${String(baselineY)}" font-size="${String(stateSize)}" fill="#e8e8ee">${state}`,
+		`<tspan fill="#9a9aa8"> · ${name}</tspan>`,
+		`</text></g></svg>`
+	].join("");
 }
-function buildStateSvg(spec, overlay) {
+/**
+* The GENERATED card: no picture exists, so this IS the picture. Opaque by
+* necessity — anything translucent here shows black through it.
+*/
+function buildStateSvg(spec) {
 	const stateSize = Math.max(12, Math.round(spec.width / 12));
 	const nameSize = Math.max(9, Math.round(spec.width / 26));
 	const state = escapeCourtesyText(courtesyLabel(spec.reason));
 	const name = escapeCourtesyText(spec.deviceName);
 	const midY = spec.height / 2;
-	const washOpacity = overlay ? "0.62" : "1";
 	const textStroke = Math.max(1, Math.round(spec.width / 320));
 	return [
 		`<svg xmlns="http://www.w3.org/2000/svg" width="${String(spec.width)}" height="${String(spec.height)}">`,
-		`<rect width="100%" height="100%" fill="${courtesyBackground(spec.reason)}" fill-opacity="${washOpacity}"/>`,
+		`<rect width="100%" height="100%" fill="${courtesyBackground(spec.reason)}" fill-opacity="1"/>`,
 		`<g font-family="${COURTESY_FONT_STACK}" text-anchor="middle" paint-order="stroke" stroke="#111118" stroke-width="${String(textStroke)}">`,
 		`<text x="50%" y="${String(Math.round(midY))}" font-size="${String(stateSize)}" fill="#e8e8ee">${state}</text>`,
 		`<text x="50%" y="${String(Math.round(midY + stateSize))}" font-size="${String(nameSize)}" fill="#9a9aa8">${name}</text>`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/system",
-  "version": "1.2.243",
+  "version": "1.2.245",
   "description": "Core addon for CamStack — builtins, pipeline, process management, auth, logging, events",
   "keywords": [
     "camstack",