camstack 1.2.156 → 1.2.158

package/dist/{chunk-VR72SEQZ.js → chunk-GDVPY652.js}

@@ -21004,6 +21004,33 @@ var deviceExportCapability = {
     unexposeDevice: method(UnexposeInputSchema, external_exports.void(), { kind: "mutation" })
   }
 };
+var LOCATION_ICON_IDS = [
+  "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"
+];
+var LocationIconIdSchema = external_exports.enum(LOCATION_ICON_IDS);
+var LocationIconAssignmentSchema = external_exports.object({
+  locationKey: external_exports.string(),
+  icon: LocationIconIdSchema
+});
 var ProviderStatusSchema = external_exports.object({
   connected: external_exports.boolean(),
   deviceCount: external_exports.number(),
@@ -21653,7 +21680,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(external_exports.object({
       name: external_exports.string(),
       cascade: external_exports.boolean().optional()
@@ -21674,7 +21705,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(external_exports.object({
       from: external_exports.string(),
       to: external_exports.string()
@@ -21682,6 +21719,39 @@ 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(external_exports.void(), external_exports.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(external_exports.object({
+      location: external_exports.string(),
+      icon: LocationIconIdSchema.nullable()
+    }), external_exports.void(), {
+      kind: "mutation",
+      auth: "admin"
+    }),
     /** Soft-disable / re-enable the device. Drivers consult
     *  `BaseDevice.disabled` to gate lifecycle hooks. */
     setDisabled: method(external_exports.object({
@@ -27299,6 +27369,7 @@ var MediaFileKindEnum = external_exports.enum([
   "keyFrame",
   "keyFrameSmall",
   "thumbnailSmall",
+  "confirmationCrop",
   "sceneFrame"
 ]);
 var MediaFileRefSchema = external_exports.object({
@@ -42949,6 +43020,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "view"
   },
+  "deviceManager.listLocationIcons": {
+    capName: "device-manager",
+    capScope: "system",
+    addonId: null,
+    access: "view"
+  },
   "deviceManager.listLocations": {
     capName: "device-manager",
     capScope: "system",
@@ -43093,6 +43170,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "create"
   },
+  "deviceManager.setLocationIcon": {
+    capName: "device-manager",
+    capScope: "system",
+    addonId: null,
+    access: "create"
+  },
   "deviceManager.setMetadata": {
     capName: "device-manager",
     capScope: "system",

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runDiscover
-} from "./chunk-VR72SEQZ.js";
+} from "./chunk-GDVPY652.js";
 import "./chunk-LMMQX4CK.js";
 
 // src/cli.ts
@@ -38,7 +38,7 @@ async function runServe(args) {
     ...typeof values.data === "string" ? { data: values.data } : {}
   };
   Object.assign(process.env, buildServeEnv(opts));
-  await import("./launcher-OPKFHSZH.js");
+  await import("./launcher-MMBEAJYM.js");
 }
 
 // src/commands/agent.ts
@@ -83,7 +83,7 @@ async function runAgent(args) {
     ...typeof values.port === "string" ? { port: values.port } : {}
   };
   Object.assign(process.env, buildAgentEnv(opts));
-  await import("./launcher-OPKFHSZH.js");
+  await import("./launcher-MMBEAJYM.js");
 }
 
 // src/commands/setup.ts
@@ -1140,7 +1140,7 @@ function isUnknown(_value) {
   return true;
 }
 async function resolveServerInteractive(presetNamespace) {
-  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-63TJXVH3.js");
+  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-HGPO3SNF.js");
   if (presetNamespace) {
     const spinner4 = clack.spinner();
     spinner4.start(`Discovering hub on LAN (namespace "${presetNamespace}")`);

package/dist/{discover-63TJXVH3.js → discover-HGPO3SNF.js}

@@ -5,7 +5,7 @@ import {
   filterHubNodes,
   resolveHubFromDiscovered,
   runDiscover
-} from "./chunk-VR72SEQZ.js";
+} from "./chunk-GDVPY652.js";
 import "./chunk-LMMQX4CK.js";
 export {
   DEFAULT_HUB_HTTPS_PORT,

package/dist/{launcher-OPKFHSZH.js → launcher-MMBEAJYM.js}

@@ -23633,9 +23633,9 @@ var require_zod = __commonJS({
   }
 });
 
-// ../system/dist/dist-C6JIhqS6.js
-var require_dist_C6JIhqS6 = __commonJS({
-  "../system/dist/dist-C6JIhqS6.js"(exports) {
+// ../system/dist/dist-D6kqBW1G.js
+var require_dist_D6kqBW1G = __commonJS({
+  "../system/dist/dist-D6kqBW1G.js"(exports) {
     "use strict";
     var zod = require_zod();
     var EventCategory = /* @__PURE__ */ (function(EventCategory2) {
@@ -31763,6 +31763,35 @@ var require_dist_C6JIhqS6 = __commonJS({
         unexposeDevice: method(UnexposeInputSchema, zod.z.void(), { kind: "mutation" })
       }
     };
+    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"
+    ]);
+    var LocationIconAssignmentSchema = zod.z.object({
+      locationKey: zod.z.string(),
+      icon: LocationIconIdSchema
+    });
+    function locationIconKey(label) {
+      return label.trim().toLowerCase();
+    }
     var ProviderStatusSchema = zod.z.object({
       connected: zod.z.boolean(),
       deviceCount: zod.z.number(),
@@ -32412,7 +32441,11 @@ var require_dist_C6JIhqS6 = __commonJS({
         *  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()
@@ -32433,7 +32466,13 @@ var require_dist_C6JIhqS6 = __commonJS({
         *  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()
@@ -32441,6 +32480,39 @@ var require_dist_C6JIhqS6 = __commonJS({
           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"
+        }),
         /** Soft-disable / re-enable the device. Drivers consult
         *  `BaseDevice.disabled` to gate lifecycle hooks. */
         setDisabled: method(zod.z.object({
@@ -38051,6 +38123,7 @@ var require_dist_C6JIhqS6 = __commonJS({
       "keyFrame",
       "keyFrameSmall",
       "thumbnailSmall",
+      "confirmationCrop",
       "sceneFrame"
     ]);
     var MediaFileSchema = zod.z.object({
@@ -54340,6 +54413,12 @@ var require_dist_C6JIhqS6 = __commonJS({
         addonId: null,
         access: "view"
       },
+      "deviceManager.listLocationIcons": {
+        capName: "device-manager",
+        capScope: "system",
+        addonId: null,
+        access: "view"
+      },
       "deviceManager.listLocations": {
         capName: "device-manager",
         capScope: "system",
@@ -54484,6 +54563,12 @@ var require_dist_C6JIhqS6 = __commonJS({
         addonId: null,
         access: "create"
       },
+      "deviceManager.setLocationIcon": {
+        capName: "device-manager",
+        capScope: "system",
+        addonId: null,
+        access: "create"
+      },
       "deviceManager.setMetadata": {
         capName: "device-manager",
         capScope: "system",
@@ -61908,6 +61993,12 @@ var require_dist_C6JIhqS6 = __commonJS({
         return LegacyStorageLocationDefaultSchema;
       }
     });
+    Object.defineProperty(exports, "LocationIconIdSchema", {
+      enumerable: true,
+      get: function() {
+        return LocationIconIdSchema;
+      }
+    });
     Object.defineProperty(exports, "METHOD_ACCESS_MAP", {
       enumerable: true,
       get: function() {
@@ -62310,6 +62401,12 @@ var require_dist_C6JIhqS6 = __commonJS({
         return localNetworkCapability;
       }
     });
+    Object.defineProperty(exports, "locationIconKey", {
+      enumerable: true,
+      get: function() {
+        return locationIconKey;
+      }
+    });
     Object.defineProperty(exports, "logDestinationCapability", {
       enumerable: true,
       get: function() {
@@ -62556,7 +62653,7 @@ var require_alerts_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C6JIhqS6();
+    var require_dist10 = require_dist_D6kqBW1G();
     function selectExpired(alerts, cutoffMs) {
       return alerts.filter((a) => a.createdAt < cutoffMs).sort((a, b) => a.createdAt - b.createdAt).map((a) => a.id);
     }
@@ -63375,7 +63472,7 @@ var require_console_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C6JIhqS6();
+    var require_dist10 = require_dist_D6kqBW1G();
     var require_formatter = require_formatter_DqAKDlvN();
     var LEVEL_RANK = {
       debug: 0,
@@ -63469,7 +63566,7 @@ var require_core_blocks_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C6JIhqS6();
+    var require_dist10 = require_dist_D6kqBW1G();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     node_fs_promises = require_chunk.__toESM(node_fs_promises);
@@ -64366,11 +64463,11 @@ var require_core_blocks = __commonJS({
   }
 });
 
-// ../system/dist/retired-settings-keys-C53Y2Q1C.js
-var require_retired_settings_keys_C53Y2Q1C = __commonJS({
-  "../system/dist/retired-settings-keys-C53Y2Q1C.js"(exports) {
+// ../system/dist/retired-settings-keys-BPIyHR4_.js
+var require_retired_settings_keys_BPIyHR4 = __commonJS({
+  "../system/dist/retired-settings-keys-BPIyHR4_.js"(exports) {
     "use strict";
-    var require_dist10 = require_dist_C6JIhqS6();
+    var require_dist10 = require_dist_D6kqBW1G();
     function settingsStoreIsAuthoritativeHere(env) {
       const raw = (env["CAMSTACK_ROLE"] ?? "").trim().toLowerCase();
       return raw === "" || raw === "hub";
@@ -66607,8 +66704,8 @@ var require_device_manager_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C6JIhqS6();
-    var require_retired_settings_keys = require_retired_settings_keys_C53Y2Q1C();
+    var require_dist10 = require_dist_D6kqBW1G();
+    var require_retired_settings_keys = require_retired_settings_keys_BPIyHR4();
     var node_crypto = __require("crypto");
     var _camstack_types_node = require_node();
     var JOB_HISTORY = 20;
@@ -66830,13 +66927,15 @@ var require_device_manager_addon = __commonJS({
         const startedAt = this.now();
         try {
           const per = input.perCandidate?.[childNativeId];
-          const entry = (await provider.adopt({
+          const adoptCandidate = async () => await provider.adopt({
             integrationId: input.integrationId,
             childNativeIds: [childNativeId],
             ...input.filter !== void 0 ? { filter: input.filter } : {},
             ...input.importLocations !== void 0 ? { importLocations: input.importLocations } : {},
             ...per !== void 0 ? { perCandidate: { [childNativeId]: per } } : {}
-          })).adopted[0];
+          });
+          const fence = this.deps.removalFence;
+          const entry = (fence === void 0 ? await adoptCandidate() : await fence.runUnfenced(adoptCandidate)).adopted[0];
           if (!entry) {
             job.results.push({
               childNativeId,
@@ -70332,6 +70431,42 @@ var require_device_manager_addon = __commonJS({
         await pctx.settings.writeAddonStore({ locations: [...current, trimmed] });
       });
     }
+    async function listLocationIcons(pctx) {
+      const icons = (await pctx.metaStore.readStore()).locationIcons ?? {};
+      return Object.entries(icons).map(([locationKey, icon]) => ({
+        locationKey,
+        icon
+      })).toSorted((a, b) => a.locationKey.localeCompare(b.locationKey));
+    }
+    async function setLocationIcon(pctx, input) {
+      const trimmed = input.location.trim();
+      if (trimmed.length === 0) throw new Error("[device-manager] setLocationIcon: location must be non-empty");
+      const key = require_dist10.locationIconKey(trimmed);
+      await pctx.bindingsDeps.withAddonStoreWriteLock(async () => {
+        const icons = (await pctx.metaStore.readStore()).locationIcons ?? {};
+        if (input.icon === null) {
+          if (!(key in icons)) return;
+          const { [key]: _cleared, ...kept } = icons;
+          await pctx.settings.writeAddonStore({ locationIcons: kept });
+          return;
+        }
+        if (icons[key] === input.icon) return;
+        await pctx.settings.writeAddonStore({ locationIcons: {
+          ...icons,
+          [key]: input.icon
+        } });
+      });
+    }
+    function renameLocationIcon(icons, fromKey, toKey) {
+      const moved = icons[fromKey];
+      if (moved === void 0) return null;
+      if (fromKey === toKey) return null;
+      const { [fromKey]: _dropped, ...rest } = icons;
+      return toKey in rest ? rest : {
+        ...rest,
+        [toKey]: moved
+      };
+    }
     async function renameLocation(pctx, input) {
       const from = input.from.trim();
       const to = input.to.trim();
@@ -70340,13 +70475,19 @@ var require_device_manager_addon = __commonJS({
       const fromKey = from.toLowerCase();
       const toKey = to.toLowerCase();
       await pctx.bindingsDeps.withAddonStoreWriteLock(async () => {
-        const current = (await pctx.metaStore.readStore()).locations ?? [];
-        if (!current.some((l) => l.trim().toLowerCase() === fromKey)) return;
+        const store = await pctx.metaStore.readStore();
+        const current = store.locations ?? [];
+        const registered = current.some((l) => l.trim().toLowerCase() === fromKey);
+        const movedIcons = renameLocationIcon(store.locationIcons ?? {}, fromKey, toKey);
+        if (!registered && movedIcons === null) return;
         const kept = current.filter((l) => {
           const key = l.trim().toLowerCase();
           return key !== fromKey && key !== toKey;
         });
-        await pctx.settings.writeAddonStore({ locations: [...kept, to] });
+        await pctx.settings.writeAddonStore({
+          ...registered ? { locations: [...kept, to] } : {},
+          ...movedIcons !== null ? { locationIcons: movedIcons } : {}
+        });
       });
       const moved = await pctx.metaStore.withMetaWriteLock(async () => {
         const out = [];
@@ -70384,10 +70525,19 @@ var require_device_manager_addon = __commonJS({
       const trimmed = input.name.trim();
       if (trimmed.length === 0) return;
       await pctx.bindingsDeps.withAddonStoreWriteLock(async () => {
-        const current = (await pctx.metaStore.readStore()).locations ?? [];
-        const remaining = current.filter((l) => l.toLowerCase() !== trimmed.toLowerCase());
-        if (remaining.length === current.length) return;
-        await pctx.settings.writeAddonStore({ locations: remaining });
+        const store = await pctx.metaStore.readStore();
+        const current = store.locations ?? [];
+        const key = require_dist10.locationIconKey(trimmed);
+        const remaining = current.filter((l) => l.toLowerCase() !== key);
+        const droppedLabel = remaining.length !== current.length;
+        const icons = store.locationIcons ?? {};
+        const droppedIcon = key in icons;
+        if (!droppedLabel && !droppedIcon) return;
+        const { [key]: _removedIcon, ...keptIcons } = icons;
+        await pctx.settings.writeAddonStore({
+          ...droppedLabel ? { locations: remaining } : {},
+          ...droppedIcon ? { locationIcons: keptIcons } : {}
+        });
       });
       if (input.cascade !== true) return;
       const cleared = await pctx.metaStore.withMetaWriteLock(async () => {
@@ -70478,12 +70628,24 @@ var require_device_manager_addon = __commonJS({
       const nextDeviceId = raw["nextDeviceId"];
       const locations = raw["locations"];
       const roleDisplayDefaults = raw["roleDisplayDefaults"];
+      const locationIcons = decodeLocationIcons(raw["locationIcons"]);
       return {
         ...typeof nextDeviceId === "number" && Number.isFinite(nextDeviceId) ? { nextDeviceId } : {},
         ...Array.isArray(locations) ? { locations: locations.filter((l) => typeof l === "string") } : {},
-        ...isRoleDisplayDefaults(roleDisplayDefaults) ? { roleDisplayDefaults } : {}
+        ...isRoleDisplayDefaults(roleDisplayDefaults) ? { roleDisplayDefaults } : {},
+        ...locationIcons !== null ? { locationIcons } : {}
       };
     }
+    function decodeLocationIcons(raw) {
+      if (raw === null || typeof raw !== "object" || Array.isArray(raw)) return null;
+      const out = {};
+      for (const [key, value] of Object.entries(raw)) {
+        const parsed = require_dist10.LocationIconIdSchema.safeParse(value);
+        if (!parsed.success) continue;
+        out[key] = parsed.data;
+      }
+      return out;
+    }
     function isRoleDisplayDefaults(value) {
       return value !== null && typeof value === "object" && !Array.isArray(value);
     }
@@ -71878,6 +72040,17 @@ var require_device_manager_addon = __commonJS({
       remoteNativeCaps = /* @__PURE__ */ new Map();
       /** Background adoption jobs — lazily constructed (needs `ctx.logger`). */
       adoptionJobEngine = null;
+      /**
+      * ONE removal fence for this process, shared by the provider context and the
+      * adoption-job engine.
+      *
+      * It used to be constructed inline into the context, so the job engine had
+      * no way to reach it and an operator re-adopting hardware they had just
+      * deleted was refused for the whole 5-minute TTL — their own action, denied.
+      * Two fences would be worse than one: the engine would suspend a fence that
+      * `allocateDeviceId` never consults.
+      */
+      removalFence = createRemovalFence();
       /** The runtime-state mirror, asserted present (constructed in onInitialize). */
       get stateMirror() {
         if (!this.stateMirrorImpl) throw new Error("DeviceManagerAddon: state mirror accessed before onInitialize");
@@ -71915,7 +72088,8 @@ var require_device_manager_addon = __commonJS({
       get adoptionJobsImpl() {
         if (!this.adoptionJobEngine) this.adoptionJobEngine = new AdoptionJobEngine({
           resolveProvider: async (addonId) => this.requireDeviceAdoptionProvider(addonId),
-          logger: this.ctx.logger
+          logger: this.ctx.logger,
+          removalFence: this.removalFence
         });
         return this.adoptionJobEngine;
       }
@@ -72066,7 +72240,7 @@ var require_device_manager_addon = __commonJS({
           registry,
           bindingsDeps: this.bindingsDeps,
           migrationGuard: createMigrationGuard(),
-          removalFence: createRemovalFence(),
+          removalFence: this.removalFence,
           requireDeviceOps,
           stampIntegrationId: stampIntegrationId$1,
           get provider() {
@@ -72112,6 +72286,8 @@ var require_device_manager_addon = __commonJS({
           addLocation: (input) => addLocation(pctx, input),
           removeLocation: (input) => removeLocation(pctx, input),
           renameLocation: (input) => renameLocation(pctx, input),
+          listLocationIcons: () => listLocationIcons(pctx),
+          setLocationIcon: (input) => setLocationIcon(pctx, input),
           listPersistedByAddon: (input) => listPersistedByAddon(pctx, input),
           listAll: (input) => listAll(pctx, input),
           getDevice: (input) => getDevice(pctx, input),
@@ -72318,7 +72494,7 @@ var require_hub_forwarder = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C6JIhqS6();
+    var require_dist10 = require_dist_D6kqBW1G();
     var require_formatter = require_formatter_DqAKDlvN();
     var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;
     var HubForwarderDestination = class {
@@ -72455,7 +72631,7 @@ var require_liveness_monitor_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C6JIhqS6();
+    var require_dist10 = require_dist_D6kqBW1G();
     var NO_DEVICES = "liveness:no-devices";
     var ALL_OFFLINE = "liveness:all-devices-offline";
     var NO_FOOTAGE_PREFIX = "liveness:no-footage:";
@@ -72651,7 +72827,7 @@ var require_local_auth_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C6JIhqS6();
+    var require_dist10 = require_dist_D6kqBW1G();
     var node_crypto = __require("crypto");
     node_crypto = require_chunk.__toESM(node_crypto);
     var crypto$1 = __require("crypto");
@@ -80464,7 +80640,7 @@ var require_loki_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C6JIhqS6();
+    var require_dist10 = require_dist_D6kqBW1G();
     function sanitizeLabelName(raw) {
       const replaced = raw.replaceAll(/[^a-zA-Z0-9_]/g, "_");
       return /^[a-zA-Z_]/.test(replaced) ? replaced : `_${replaced}`;
@@ -81051,7 +81227,7 @@ var require_native_metrics_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C6JIhqS6();
+    var require_dist10 = require_dist_D6kqBW1G();
     var node_fs_promises = __require("fs/promises");
     var node_fs = __require("fs");
     node_fs = require_chunk.__toESM(node_fs);
@@ -83804,7 +83980,7 @@ var require_filesystem_storage_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C6JIhqS6();
+    var require_dist10 = require_dist_D6kqBW1G();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     var node_path = __require("path");
@@ -85031,8 +85207,8 @@ var require_sqlite_settings_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C6JIhqS6();
-    var require_retired_settings_keys = require_retired_settings_keys_C53Y2Q1C();
+    var require_dist10 = require_dist_D6kqBW1G();
+    var require_retired_settings_keys = require_retired_settings_keys_BPIyHR4();
     var require_wal_checkpoint_policy = require_wal_checkpoint_policy_CCJZngds();
     var node_crypto = __require("crypto");
     var node_path = __require("path");
@@ -87819,7 +87995,7 @@ var require_storage_orchestrator_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C6JIhqS6();
+    var require_dist10 = require_dist_D6kqBW1G();
     var require_hub_cap_forward = require_hub_cap_forward_DmHNjbB0();
     var zod = require_zod();
     var node_crypto = __require("crypto");
@@ -91546,7 +91722,7 @@ var require_system_config_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C6JIhqS6();
+    var require_dist10 = require_dist_D6kqBW1G();
     var SECTION_TITLES = {
       server: "Server",
       auth: "Authentication"
@@ -109607,7 +109783,7 @@ var require_winston_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C6JIhqS6();
+    var require_dist10 = require_dist_D6kqBW1G();
     var require_formatter = require_formatter_DqAKDlvN();
     var node_path = __require("path");
     node_path = require_chunk.__toESM(node_path);
@@ -135874,7 +136050,7 @@ var require_dist3 = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_C6JIhqS6();
+    var require_dist10 = require_dist_D6kqBW1G();
     var require_builtins_alerts_alerts_addon = require_alerts_addon();
     require_alerts();
     var require_formatter = require_formatter_DqAKDlvN();
@@ -225125,6 +225301,41 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         unexposeDevice: require_sleep.method(UnexposeInputSchema, zod.z.void(), { kind: "mutation" })
       }
     };
+    var LOCATION_ICON_IDS = [
+      "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"
+    ];
+    var LOCATION_ICON_FALLBACK = "map-pin";
+    var LocationIconIdSchema = zod.z.enum(LOCATION_ICON_IDS);
+    var LocationIconAssignmentSchema = zod.z.object({
+      locationKey: zod.z.string(),
+      icon: LocationIconIdSchema
+    });
+    function locationIconKey(label) {
+      return label.trim().toLowerCase();
+    }
+    function resolveLocationIcon(value) {
+      const parsed = LocationIconIdSchema.safeParse(value);
+      return parsed.success ? parsed.data : LOCATION_ICON_FALLBACK;
+    }
     var ProviderStatusSchema = zod.z.object({
       connected: zod.z.boolean(),
       deviceCount: zod.z.number(),
@@ -225774,7 +225985,11 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         *  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: require_sleep.method(zod.z.object({
           name: zod.z.string(),
           cascade: zod.z.boolean().optional()
@@ -225795,7 +226010,13 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         *  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: require_sleep.method(zod.z.object({
           from: zod.z.string(),
           to: zod.z.string()
@@ -225803,6 +226024,39 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
           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: require_sleep.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: require_sleep.method(zod.z.object({
+          location: zod.z.string(),
+          icon: LocationIconIdSchema.nullable()
+        }), zod.z.void(), {
+          kind: "mutation",
+          auth: "admin"
+        }),
         /** Soft-disable / re-enable the device. Drivers consult
         *  `BaseDevice.disabled` to gate lifecycle hooks. */
         setDisabled: require_sleep.method(zod.z.object({
@@ -232243,6 +232497,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       "keyFrame",
       "keyFrameSmall",
       "thumbnailSmall",
+      "confirmationCrop",
       "sceneFrame"
     ]);
     var MediaFileRefSchema = zod.z.object({
@@ -252279,6 +252534,12 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         addonId: null,
         access: "view"
       },
+      "deviceManager.listLocationIcons": {
+        capName: "device-manager",
+        capScope: "system",
+        addonId: null,
+        access: "view"
+      },
       "deviceManager.listLocations": {
         capName: "device-manager",
         capScope: "system",
@@ -252423,6 +252684,12 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         addonId: null,
         access: "create"
       },
+      "deviceManager.setLocationIcon": {
+        capName: "device-manager",
+        capScope: "system",
+        addonId: null,
+        access: "create"
+      },
       "deviceManager.setMetadata": {
         capName: "device-manager",
         capScope: "system",
@@ -259989,6 +260256,8 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
           addLocation: (input) => dispatch("deviceManager", "addLocation", "mutation", input),
           removeLocation: (input) => dispatch("deviceManager", "removeLocation", "mutation", input),
           renameLocation: (input) => dispatch("deviceManager", "renameLocation", "mutation", input),
+          listLocationIcons: (input) => dispatch("deviceManager", "listLocationIcons", "query", input),
+          setLocationIcon: (input) => dispatch("deviceManager", "setLocationIcon", "mutation", input),
           listPersistedByAddon: (input) => dispatch("deviceManager", "listPersistedByAddon", "query", input),
           listAll: (input) => dispatch("deviceManager", "listAll", "query", input),
           getChildren: (input) => dispatch("deviceManager", "getChildren", "query", input),
@@ -263536,6 +263805,8 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.LEGACY_READ_ONLY_CONFIG_KEY = LEGACY_READ_ONLY_CONFIG_KEY;
     exports.LOAD_CONTRIBUTION_ATTRIBUTIONS = LOAD_CONTRIBUTION_ATTRIBUTIONS;
     exports.LOAD_CONTRIBUTION_ROLES = LOAD_CONTRIBUTION_ROLES;
+    exports.LOCATION_ICON_FALLBACK = LOCATION_ICON_FALLBACK;
+    exports.LOCATION_ICON_IDS = LOCATION_ICON_IDS;
     exports.LOG_CHANNEL_TICK_MS = LOG_CHANNEL_TICK_MS;
     exports.LOG_LEVEL_RANK = LOG_LEVEL_RANK;
     exports.LTS_SCOPE_CLASS_SEPARATOR = LTS_SCOPE_CLASS_SEPARATOR;
@@ -263576,6 +263847,8 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.LlmUsageSchema = LlmUsageSchema;
     exports.LoadContributionSchema = LoadContributionSchema;
     exports.LocateSegmentResultSchema = LocateSegmentResultSchema;
+    exports.LocationIconAssignmentSchema = LocationIconAssignmentSchema;
+    exports.LocationIconIdSchema = LocationIconIdSchema;
     exports.LocationStatSchema = LocationStatSchema;
     exports.LockControlStatusSchema = LockControlStatusSchema;
     exports.LockStateSchema = LockStateSchema;
@@ -264475,6 +264748,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.llmRuntimeCapability = llmRuntimeCapability;
     exports.loadContributionCapability = loadContributionCapability;
     exports.localNetworkCapability = localNetworkCapability;
+    exports.locationIconKey = locationIconKey;
     exports.locationSimilarity = locationSimilarity;
     exports.lockControlCapability = lockControlCapability;
     exports.logBannerArgs = require_canonical_hash.logBannerArgs;
@@ -264599,6 +264873,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.resolveEgressDecodeHwAccel = resolveEgressDecodeHwAccel;
     exports.resolveFormat = resolveFormat;
     exports.resolveHydratedFieldValue = require_sleep.resolveHydratedFieldValue;
+    exports.resolveLocationIcon = resolveLocationIcon;
     exports.resolveLocationMode = resolveLocationMode;
     exports.resolveMethodAuth = resolveMethodAuth;
     exports.resolveModelFormat = resolveModelFormat;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "camstack",
-  "version": "1.2.156",
+  "version": "1.2.158",
   "description": "CLI tool for managing and running CamStack server",
   "keywords": [
     "camstack",