@camstack/system 1.2.242 → 1.2.244

package/dist/{dist-DkGEz_3L.mjs → dist-4MS1GNc8.mjs}

@@ -11388,6 +11388,126 @@ var deviceExportCapability = {
 		unexposeDevice: method(UnexposeInputSchema, z.void(), { kind: "mutation" })
 	}
 };
+/** Wire/storage schema for one icon id. */
+var LocationIconIdSchema = 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 = z.object({
+	locationKey: 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 = z.object({
+	locationKey: z.string(),
+	description: 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 = z.object({
+	zoneKey: z.string(),
+	label: 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: z.array(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 = z.object({
 	connected: z.boolean(),
 	deviceCount: 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(z.object({
 			name: z.string(),
 			cascade: 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(z.object({
 			from: z.string(),
 			to: 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(z.void(), 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(z.object({
+			location: z.string(),
+			icon: LocationIconIdSchema.nullable()
+		}), 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(z.void(), 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(z.object({
+			location: z.string(),
+			description: z.string().max(400).nullable()
+		}), 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(z.void(), 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(z.object({
+			name: z.string(),
+			icon: LocationIconIdSchema.nullable().optional()
+		}), 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(z.object({ name: z.string() }), 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(z.object({
+			from: z.string(),
+			to: z.string()
+		}), 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(z.object({
+			location: z.string(),
+			zone: z.string().nullable()
+		}), z.void(), {
+			kind: "mutation",
+			auth: "admin"
+		}),
 		/** Soft-disable / re-enable the device. Drivers consult
 		*  `BaseDevice.disabled` to gate lifecycle hooks. */
 		setDisabled: method(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",
@@ -46673,4 +46978,4 @@ function enumerateInferenceDevices(hw) {
 	return out;
 }
 //#endregion
-export { evictionPolicyOfLocation as $, DeviceRole as $t, addonSettingsCapability as A, resolveLocationMode as At, coreBlockIdFromAddonId as B, storageOccupancyCapability as Bt, ScopedTokenSchema as C, objectInputDeclaresAddonId as Ct, StorageMigrationJobSchema as D, reducePoints as Dt, StorageLocationTypeSchema as E, procedureAuthKey as Et, bareAddonId as F, scoreRuntimes as Ft, deviceManagerCapability as G, vectorStoreCapability as Gt, dataStoreProviderCapability as H, streamQualityLabel as Ht, batteryCapability as I, settingsStoreCapability as It, doorbellCapability as J, BaseAddon as Jt, deviceStateCapability as K, withLocationMode as Kt, buildStreamParamsConfigSchema as L, snapshotCapability as Lt, alertsCapability as M, runtimeStatePolicyFor as Mt, authProviderCapability as N, scopesAllowAddon as Nt, UserRecordSchema as O, resolveBucketMs as Ot, backupCapability as P, scopesAllowDeviceCap as Pt, evaluateSensorEdge as Q, DeviceFeature as Qt, collectSecretConfigKeys as R, storageCapability as Rt, STREAM_PROFILE_META as S, normalizeUnit as St, StorageLocationModeSchema as T, platformProbeCapability as Tt, decodeVectorBase64 as U, userManagementCapability as Ut, coreBlocksCapability as V, storageProviderCapability as Vt, deriveBatteryPresence as W, vectorDimFromBase64 as Wt, enumerateItemArrayFields as X, DEVICE_SETTINGS_CONTRIBUTION_METHODS as Xt, enumerateInferenceDevices as Y, DATAPLANE_SECRET_HEADER as Yt, enumerateSchemaFields as Z, DEVICE_STATUS_METHOD as Zt, RUNTIME_DEFAULTS as _, resolveCapMount as _n, looseSchema as _t, CAMERA_SWITCH_ORDER as a, asNumber as an, isCollectionArrayMethod as at, SOURCE_DEVICE_TYPES as b, EventCategory as bn, metricsProviderCapability as bt, CORE_BLOCK_ADDON_PREFIX as c, emitDownForOwnedCaps as cn, isSameAddonId as ct, DeclaredDevices as d, hydrateSchema as dn, kebabToCamel as dt, DeviceType as en, extractNestedAddonId as et, DeviceStatusSchema as f, isDeviceConfigCap as fn, legacyModeOf as ft, REDACTED_SECRET as g, readinessKey as gn, logLevelAtMost as gt, METHOD_ACCESS_MAP as h, parseJsonUnknown as hn, logDestinationCapability as ht, BatteryStatusSchema as i, asJsonObject as in, isArrayOutputSchema as it, addonWidgetsCapability as j, resolveMethodAuth as jt, addonPagesCapability as k, resolveContainerPrimaryChild as kt, CoreBlockSchema as l, emitReadiness as ln, isSourceCap as lt, LegacyStorageLocationDefaultSchema as m, parseJsonObject as mn, localNetworkCapability as mt, AlertSchema as n, ReadinessTimeoutError as nn, foldSnapshotByFunction as nt, CAP_NAMES_WITH_STATUS as o, asString as on, isLocationEnabled as ot, LOG_LEVEL_RANK as p, nodePin as pn, lifecycleJobSchema as pt, deviceStatusCapability as q, errMsg as qt, ApiKeyRecordSchema as r, WELL_KNOWN_TAB_MAP as rn, gbToBytes as rt, CORE_BLOCKS_ADDON_ID as s, createEvent as sn, isObjectInput as st, ALL_CAPABILITY_DEFINITIONS as t, ReadinessRegistry as tn, filesystemBrowseCapability as tt, DEFAULT_FIRST_SIGHTING_FRESHNESS_MS as u, expandCapMethods as un, isVoidInput as ut, RecordingStatusSchema as v, scopeKey as vn, mayReadLocation as vt, StorageCleanupJobSchema as w, parseStreamParamsFormPatch as wt, STORAGE_ACCESS_FALLBACK as x, modeMayWrite as xt, SOURCE_CAPS as y, sleep as yn, mayWriteToLocation as yt, coreBlockAddonId as z, storageMigrationCapability as zt };
+export { evaluateSensorEdge as $, DEVICE_SETTINGS_CONTRIBUTION_METHODS as $t, addonPagesCapability as A, resolveBucketMs as At, coreBlockAddonId as B, snapshotCapability as Bt, STREAM_PROFILE_META as C, EventCategory as Cn, modeMayWrite as Ct, StorageLocationTypeSchema as D, platformProbeCapability as Dt, StorageLocationModeSchema as E, parseStreamParamsFormPatch as Et, backupCapability as F, scopesAllowAddon as Ft, deriveBatteryPresence as G, streamQualityLabel as Gt, coreBlocksCapability as H, storageMigrationCapability as Ht, bareAddonId as I, scopesAllowDeviceCap as It, deviceStatusCapability as J, vectorStoreCapability as Jt, deviceManagerCapability as K, userManagementCapability as Kt, batteryCapability as L, scoreRuntimes as Lt, addonWidgetsCapability as M, resolveLocationMode as Mt, alertsCapability as N, resolveMethodAuth as Nt, StorageMigrationJobSchema as O, procedureAuthKey as Ot, authProviderCapability as P, runtimeStatePolicyFor as Pt, enumerateSchemaFields as Q, DATAPLANE_SECRET_HEADER as Qt, buildStreamParamsConfigSchema as R, settingsStoreCapability as Rt, STORAGE_ACCESS_FALLBACK as S, sleep as Sn, metricsProviderCapability as St, StorageCleanupJobSchema as T, objectInputDeclaresAddonId as Tt, dataStoreProviderCapability as U, storageOccupancyCapability as Ut, coreBlockIdFromAddonId as V, storageCapability as Vt, decodeVectorBase64 as W, storageProviderCapability as Wt, enumerateInferenceDevices as X, errMsg as Xt, doorbellCapability as Y, withLocationMode as Yt, enumerateItemArrayFields as Z, BaseAddon as Zt, REDACTED_SECRET as _, parseJsonObject as _n, logDestinationCapability as _t, CAMERA_SWITCH_ORDER as a, ReadinessTimeoutError as an, isArrayOutputSchema as at, SOURCE_CAPS as b, resolveCapMount as bn, mayReadLocation as bt, CORE_BLOCK_ADDON_PREFIX as c, asNumber as cn, isObjectInput as ct, DeclaredDevices as d, emitDownForOwnedCaps as dn, isVoidInput as dt, DEVICE_STATUS_METHOD as en, evictionPolicyOfLocation as et, DeviceStatusSchema as f, emitReadiness as fn, kebabToCamel as ft, METHOD_ACCESS_MAP as g, nodePin as gn, locationIconKey as gt, LocationIconIdSchema as h, isDeviceConfigCap as hn, localNetworkCapability as ht, BatteryStatusSchema as i, ReadinessRegistry as in, gbToBytes as it, addonSettingsCapability as j, resolveContainerPrimaryChild as jt, UserRecordSchema as k, reducePoints as kt, CoreBlockSchema as l, asString as ln, isSameAddonId as lt, LegacyStorageLocationDefaultSchema as m, hydrateSchema as mn, lifecycleJobSchema as mt, AlertSchema as n, DeviceRole as nn, filesystemBrowseCapability as nt, CAP_NAMES_WITH_STATUS as o, WELL_KNOWN_TAB_MAP as on, isCollectionArrayMethod as ot, LOG_LEVEL_RANK as p, expandCapMethods as pn, legacyModeOf as pt, deviceStateCapability as q, vectorDimFromBase64 as qt, ApiKeyRecordSchema as r, DeviceType as rn, foldSnapshotByFunction as rt, CORE_BLOCKS_ADDON_ID as s, asJsonObject as sn, isLocationEnabled as st, ALL_CAPABILITY_DEFINITIONS as t, DeviceFeature as tn, extractNestedAddonId as tt, DEFAULT_FIRST_SIGHTING_FRESHNESS_MS as u, createEvent as un, isSourceCap as ut, RUNTIME_DEFAULTS as v, parseJsonUnknown as vn, logLevelAtMost as vt, ScopedTokenSchema as w, normalizeUnit as wt, SOURCE_DEVICE_TYPES as x, scopeKey as xn, mayWriteToLocation as xt, RecordingStatusSchema as y, readinessKey as yn, looseSchema as yt, collectSecretConfigKeys as z, siteZoneKey as zt };