@camstack/system 1.2.242 → 1.2.244

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

@@ -11388,6 +11388,126 @@ var deviceExportCapability = {
 		unexposeDevice: method(UnexposeInputSchema, zod.z.void(), { kind: "mutation" })
 	}
 };
+/** Wire/storage schema for one icon id. */
+var LocationIconIdSchema = zod.z.enum([
+	"map-pin",
+	"house",
+	"door-open",
+	"sofa",
+	"utensils",
+	"bed-double",
+	"bath",
+	"briefcase",
+	"car",
+	"circle-parking",
+	"route",
+	"trees",
+	"umbrella",
+	"waves-ladder",
+	"fence",
+	"package",
+	"warehouse",
+	"store",
+	"sun",
+	"radar"
+]);
+/**
+* One (location, icon) assignment as it travels.
+*
+* `locationKey` is ALWAYS {@link locationIconKey} of the label — never the
+* operator's casing. The registry matches labels trimmed + case-insensitively
+* everywhere (`addLocation`, `removeLocation`, `renameLocation`), and a
+* case-only rename (`cucina` → `Cucina`) is a real edit this repo supports; a
+* map keyed on the displayed casing would orphan its entry on exactly that
+* edit. Consumers join by keying their own label through `locationIconKey`.
+*/
+var LocationIconAssignmentSchema = zod.z.object({
+	locationKey: zod.z.string(),
+	icon: LocationIconIdSchema
+});
+/**
+* The join key for a location label: trimmed, lower-cased. The ONE place this
+* derivation lives — a caller that re-spells it is a rename away from an
+* orphaned icon.
+*/
+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(),
@@ -12116,7 +12236,11 @@ var deviceManagerCapability = {
 		*  reference this label keep their `meta.location` value — the
 		*  registry is purely a suggestion list. To purge from devices,
 		*  iterate them and call `setLocation(deviceId, null)`
-		*  separately (or pass `cascade: true` to do it in one shot). */
+		*  separately (or pass `cascade: true` to do it in one shot).
+		*
+		*  The room's ICON goes with it, always — a key left behind survives in a
+		*  map nobody lists, and a room later re-created under the same name would
+		*  silently inherit an icon the operator never chose for it. */
 		removeLocation: method(zod.z.object({
 			name: zod.z.string(),
 			cascade: zod.z.boolean().optional()
@@ -12137,7 +12261,13 @@ var deviceManagerCapability = {
 		*  a suggestion list, and the devices that most need a rename are exactly
 		*  the ones carrying a label nobody registered. `to` renames onto an
 		*  existing room by MERGING into it, leaving no duplicate label. An empty
-		*  `to` throws before anything is written. */
+		*  `to` throws before anything is written.
+		*
+		*  The room's ICON travels with the rename, including when `from` was
+		*  never registered — otherwise it orphans on a key no location carries
+		*  any more. A merge keeps the TARGET's icon when it has one: renaming
+		*  "Sala" into "Salone" moves devices into Salone, it does not restyle
+		*  it. */
 		renameLocation: method(zod.z.object({
 			from: zod.z.string(),
 			to: zod.z.string()
@@ -12145,6 +12275,127 @@ var deviceManagerCapability = {
 			kind: "mutation",
 			auth: "admin"
 		}),
+		/** Every location that carries an ICON, as `(locationKey, icon)` pairs.
+		*
+		*  ADDITIVE, deliberately: `listLocations` keeps returning `string[]` —
+		*  every consumer of it (the Device Info autocomplete, the HA adoption
+		*  import, the recorder) reads a list of labels and none of them wants a
+		*  shape change. A surface that wants icons asks for them and joins.
+		*
+		*  Only assignments that EXIST are returned — a location with no icon is
+		*  absent, not `map-pin`. The fallback belongs to the renderer
+		*  (`resolveLocationIcon`), not to the store, so "the operator chose the
+		*  pin" and "the operator chose nothing" stay distinguishable.
+		*
+		*  The join key is `locationIconKey(label)` (trimmed, lower-cased) — the
+		*  same equality the registry uses everywhere. Never the operator's
+		*  casing: a case-only rename is a real edit here, and a map keyed on the
+		*  displayed spelling would orphan its entry on exactly that edit. */
+		listLocationIcons: method(zod.z.void(), zod.z.array(LocationIconAssignmentSchema)),
+		/** Set (or clear) the icon of a location label. `icon: null` removes the
+		*  assignment. The label need NOT be registered — the registry is a
+		*  suggestion list and devices carry labels nobody registered — but an
+		*  empty / whitespace-only label throws. Idempotent.
+		*
+		*  The icon vocabulary is CLOSED (`LOCATION_ICON_IDS`) because the admin UI
+		*  and the viewer draw from different icon modules; see
+		*  `device/location-icon.ts` for the list and for what a surface that
+		*  cannot draw a member must do (fall back to `map-pin`, never a hole). */
+		setLocationIcon: method(zod.z.object({
+			location: zod.z.string(),
+			icon: LocationIconIdSchema.nullable()
+		}), zod.z.void(), {
+			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({
@@ -38968,6 +39219,18 @@ 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",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.listLocations": {
 		capName: "device-manager",
 		capScope: "system",
@@ -38980,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",
@@ -39064,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",
@@ -39112,6 +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",
@@ -39142,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",
@@ -46805,6 +47110,12 @@ Object.defineProperty(exports, "LegacyStorageLocationDefaultSchema", {
 		return LegacyStorageLocationDefaultSchema;
 	}
 });
+Object.defineProperty(exports, "LocationIconIdSchema", {
+	enumerable: true,
+	get: function() {
+		return LocationIconIdSchema;
+	}
+});
 Object.defineProperty(exports, "METHOD_ACCESS_MAP", {
 	enumerable: true,
 	get: function() {
@@ -47207,6 +47518,12 @@ Object.defineProperty(exports, "localNetworkCapability", {
 		return localNetworkCapability;
 	}
 });
+Object.defineProperty(exports, "locationIconKey", {
+	enumerable: true,
+	get: function() {
+		return locationIconKey;
+	}
+});
 Object.defineProperty(exports, "logDestinationCapability", {
 	enumerable: true,
 	get: function() {
@@ -47375,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-BETx_5mH.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 { A as addonSettingsCapability, Ct as objectInputDeclaresAddonId, Et as procedureAuthKey, Nt as scopesAllowAddon, Pt as scopesAllowDeviceCap, Xt as DEVICE_SETTINGS_CONTRIBUTION_METHODS, Yt as DATAPLANE_SECRET_HEADER$1, Zt as DEVICE_STATUS_METHOD, _ as RUNTIME_DEFAULTS, _n as resolveCapMount, _t as looseSchema, an as asNumber, at as isCollectionArrayMethod, bn as EventCategory$1, cn as emitDownForOwnedCaps, dt as kebabToCamel, et as extractNestedAddonId, gn as readinessKey, gt as logLevelAtMost, h as METHOD_ACCESS_MAP, hn as parseJsonUnknown, in as asJsonObject$1, it as isArrayOutputSchema, jt as resolveMethodAuth, mn as parseJsonObject, nn as ReadinessTimeoutError, on as asString$1, p as LOG_LEVEL_RANK, pt as lifecycleJobSchema, qt as errMsg$1, sn as createEvent, st as isObjectInput, t as ALL_CAPABILITY_DEFINITIONS, tn as ReadinessRegistry, un as expandCapMethods, ut as isVoidInput, vn as scopeKey } from "./dist-DkGEz_3L.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-BnTBoLTv.js → retired-settings-keys-DBrIdOQp.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-BETx_5mH.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-BSsaf7n4.mjs → retired-settings-keys-D_5MkKII.mjs}

@@ -1,4 +1,4 @@
-import { in as asJsonObject } from "./dist-DkGEz_3L.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/package.json

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