@camstack/addon-mqtt-broker 1.1.7 → 1.1.8

package/dist/mqtt-broker.addon.js

@@ -9002,18 +9002,47 @@ object({
 	lastUpdated: number().nullable()
 });
 DeviceType.Image;
+/**
+* Robotic lawn-mower cap. Models HA `lawn_mower.*` entities — anything
+* with a mowing lifecycle plus a dock action.
+*
+* Activity follows HA's canonical lawn-mower lifecycle: `idle` /
+* `mowing` / `paused` / `docked` / `error`. `batteryLevel` (0..100) is
+* nullable — some mowers don't report a battery percentage.
+*
+* `startMowing` begins a mowing run, `pause` halts it in place, and
+* `dock` sends the mower back to its charging station.
+*/
+var LawnMowerActivitySchema = _enum([
+	"idle",
+	"mowing",
+	"paused",
+	"docked",
+	"error"
+]);
+/** Severity of the current device/error code — info (status), warning, error. */
+var DeviceCodeSeveritySchema = _enum([
+	"info",
+	"warning",
+	"error"
+]);
 object({
 	/** Lifecycle activity of the mower. */
-	activity: _enum([
-		"idle",
-		"mowing",
-		"paused",
-		"docked",
-		"error"
-	]),
+	activity: LawnMowerActivitySchema,
 	/** 0..100 battery percentage. Null when the device has no battery
 	*  reading. */
 	batteryLevel: number().min(0).max(100).nullable(),
+	/** 0..100 mowing-completion percentage of the current task, or null when no
+	*  task is active / progress is unavailable. */
+	progressPercent: number().min(0).max(100).nullable(),
+	/** Current device/event code (dynamic — mostly status, sometimes an error),
+	*  or null when unknown. */
+	currentCode: number().nullable(),
+	/** Human label for {@link currentCode}, or null when undecodable. */
+	currentCodeLabel: string().nullable(),
+	/** Severity of {@link currentCode}. `error` (and often `warning`) warrants UI
+	*  attention; `info` is normal status. */
+	severity: DeviceCodeSeveritySchema,
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number()
 });
@@ -10588,6 +10617,7 @@ var VacuumStateSchema = _enum([
 	"paused",
 	"returning",
 	"docked",
+	"drying",
 	"error"
 ]);
 /**
@@ -10626,6 +10656,12 @@ object({
 	detergent: TankStatusSchema.nullable(),
 	/** Dust bin. Null when the hardware has no dust bin. */
 	dustBin: TankStatusSchema.nullable(),
+	/** 0..100 cleaning-completion percentage of the current task, or null. */
+	progressPercent: number().min(0).max(100).nullable(),
+	/** Current error code (0 / null = no error). */
+	errorCode: number().nullable(),
+	/** Human label for {@link errorCode}, or null when none / undecodable. */
+	errorLabel: string().nullable(),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number()
 });
@@ -12067,17 +12103,32 @@ var ReleaseInputSchema = object({
 	*  the parent cascades into every accessory. */
 	camDeviceId: number().int().nonnegative()
 });
-var ResyncInputSchema = object({ 
-/** Parent CamStack device id of an adopted device. The provider resolves its
-*  source (integration/broker + native id) and re-aligns the device's
-*  structural spec (type/role/capabilities/units) with the live mapping,
-*  rebuilding any child whose class changed while preserving operator edits. */
-camDeviceId: number().int().nonnegative() });
+var ResyncInputSchema = object({
+	/** Parent CamStack device id of an adopted device. The provider resolves its
+	*  source (integration/broker + native id) and re-aligns the device's
+	*  structural spec (type/role/capabilities/units) with the live mapping,
+	*  rebuilding any child whose class changed while preserving operator edits. */
+	camDeviceId: number().int().nonnegative(),
+	/** "Resync from zero" (#19). When true, the kernel PURGES every accessory
+	*  child of `camDeviceId` BEFORE the provider re-derives the device, so the
+	*  children are rebuilt fresh from source — correct names, coords, and units —
+	*  instead of being preserved by the incremental reconcile. Use to recover from
+	*  legacy generic/placeholder names that the normal name-precedence keeps frozen
+	*  (the operator's explicit reset). Push-driven integrations (no-op resync)
+	*  rebuild on their next snapshot; pull/command integrations rebuild in `resync`.
+	*  Operator edits on the PARENT (its name, layout, primary-child pick) survive —
+	*  only the children are torn down. Omitted/false ⇒ the normal incremental
+	*  re-sync that preserves children. */
+	resetToSource: boolean().optional()
+});
 var ResyncResultSchema = object({
 	/** True when the persisted spec actually changed (children may have been rebuilt). */
 	changed: boolean(),
 	/** Number of child devices rebuilt into a new class by this re-sync. */
-	rebuiltChildren: number().int().nonnegative()
+	rebuiltChildren: number().int().nonnegative(),
+	/** Number of accessory children torn down by a `resetToSource` purge before the
+	*  provider re-derived the device. 0/absent for a normal incremental re-sync. */
+	removedChildren: number().int().nonnegative().optional()
 });
 method(object({ integrationId: string() }), object({ filters: array(AdoptionFilterSchema) }), { auth: "admin" }), method(ListCandidatesInputSchema, ListCandidatesOutputSchema, { auth: "admin" }), method(GetCandidateInputSchema, DiscoveredChildDeviceSchema.nullable(), { auth: "admin" }), method(object({ integrationId: string() }), AdoptionStatusSchema, {
 	kind: "mutation",
@@ -13844,6 +13895,11 @@ var DeviceMetaSchema = object({
 	addonId: string(),
 	type: string(),
 	name: string(),
+	/** True once an operator explicitly renamed the device via `setName`. Drives
+	*  reconcile name-precedence (preserve operator name vs adopt fresh provider
+	*  name). Absent ⇒ treated as user-named (PRESERVE) for legacy rows. See
+	*  `DeviceMeta.userNamed`. */
+	userNamed: boolean().optional(),
 	location: string().nullable(),
 	disabled: boolean(),
 	parentDeviceId: number().nullable(),
@@ -14154,6 +14210,9 @@ method(object({
 }), method(ReleaseInputSchema.extend({ addonId: string() }), _void(), {
 	kind: "mutation",
 	auth: "admin"
+}), method(ResyncInputSchema, ResyncResultSchema, {
+	kind: "mutation",
+	auth: "admin"
 }), method(object({
 	deviceId: number(),
 	key: string(),
@@ -17916,6 +17975,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.adoptionResync": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"deviceManager.allocateDeviceId": {
 		capName: "device-manager",
 		capScope: "system",

package/dist/mqtt-broker.addon.mjs

@@ -8997,18 +8997,47 @@ object({
 	lastUpdated: number().nullable()
 });
 DeviceType.Image;
+/**
+* Robotic lawn-mower cap. Models HA `lawn_mower.*` entities — anything
+* with a mowing lifecycle plus a dock action.
+*
+* Activity follows HA's canonical lawn-mower lifecycle: `idle` /
+* `mowing` / `paused` / `docked` / `error`. `batteryLevel` (0..100) is
+* nullable — some mowers don't report a battery percentage.
+*
+* `startMowing` begins a mowing run, `pause` halts it in place, and
+* `dock` sends the mower back to its charging station.
+*/
+var LawnMowerActivitySchema = _enum([
+	"idle",
+	"mowing",
+	"paused",
+	"docked",
+	"error"
+]);
+/** Severity of the current device/error code — info (status), warning, error. */
+var DeviceCodeSeveritySchema = _enum([
+	"info",
+	"warning",
+	"error"
+]);
 object({
 	/** Lifecycle activity of the mower. */
-	activity: _enum([
-		"idle",
-		"mowing",
-		"paused",
-		"docked",
-		"error"
-	]),
+	activity: LawnMowerActivitySchema,
 	/** 0..100 battery percentage. Null when the device has no battery
 	*  reading. */
 	batteryLevel: number().min(0).max(100).nullable(),
+	/** 0..100 mowing-completion percentage of the current task, or null when no
+	*  task is active / progress is unavailable. */
+	progressPercent: number().min(0).max(100).nullable(),
+	/** Current device/event code (dynamic — mostly status, sometimes an error),
+	*  or null when unknown. */
+	currentCode: number().nullable(),
+	/** Human label for {@link currentCode}, or null when undecodable. */
+	currentCodeLabel: string().nullable(),
+	/** Severity of {@link currentCode}. `error` (and often `warning`) warrants UI
+	*  attention; `info` is normal status. */
+	severity: DeviceCodeSeveritySchema,
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number()
 });
@@ -10583,6 +10612,7 @@ var VacuumStateSchema = _enum([
 	"paused",
 	"returning",
 	"docked",
+	"drying",
 	"error"
 ]);
 /**
@@ -10621,6 +10651,12 @@ object({
 	detergent: TankStatusSchema.nullable(),
 	/** Dust bin. Null when the hardware has no dust bin. */
 	dustBin: TankStatusSchema.nullable(),
+	/** 0..100 cleaning-completion percentage of the current task, or null. */
+	progressPercent: number().min(0).max(100).nullable(),
+	/** Current error code (0 / null = no error). */
+	errorCode: number().nullable(),
+	/** Human label for {@link errorCode}, or null when none / undecodable. */
+	errorLabel: string().nullable(),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number()
 });
@@ -12062,17 +12098,32 @@ var ReleaseInputSchema = object({
 	*  the parent cascades into every accessory. */
 	camDeviceId: number().int().nonnegative()
 });
-var ResyncInputSchema = object({ 
-/** Parent CamStack device id of an adopted device. The provider resolves its
-*  source (integration/broker + native id) and re-aligns the device's
-*  structural spec (type/role/capabilities/units) with the live mapping,
-*  rebuilding any child whose class changed while preserving operator edits. */
-camDeviceId: number().int().nonnegative() });
+var ResyncInputSchema = object({
+	/** Parent CamStack device id of an adopted device. The provider resolves its
+	*  source (integration/broker + native id) and re-aligns the device's
+	*  structural spec (type/role/capabilities/units) with the live mapping,
+	*  rebuilding any child whose class changed while preserving operator edits. */
+	camDeviceId: number().int().nonnegative(),
+	/** "Resync from zero" (#19). When true, the kernel PURGES every accessory
+	*  child of `camDeviceId` BEFORE the provider re-derives the device, so the
+	*  children are rebuilt fresh from source — correct names, coords, and units —
+	*  instead of being preserved by the incremental reconcile. Use to recover from
+	*  legacy generic/placeholder names that the normal name-precedence keeps frozen
+	*  (the operator's explicit reset). Push-driven integrations (no-op resync)
+	*  rebuild on their next snapshot; pull/command integrations rebuild in `resync`.
+	*  Operator edits on the PARENT (its name, layout, primary-child pick) survive —
+	*  only the children are torn down. Omitted/false ⇒ the normal incremental
+	*  re-sync that preserves children. */
+	resetToSource: boolean().optional()
+});
 var ResyncResultSchema = object({
 	/** True when the persisted spec actually changed (children may have been rebuilt). */
 	changed: boolean(),
 	/** Number of child devices rebuilt into a new class by this re-sync. */
-	rebuiltChildren: number().int().nonnegative()
+	rebuiltChildren: number().int().nonnegative(),
+	/** Number of accessory children torn down by a `resetToSource` purge before the
+	*  provider re-derived the device. 0/absent for a normal incremental re-sync. */
+	removedChildren: number().int().nonnegative().optional()
 });
 method(object({ integrationId: string() }), object({ filters: array(AdoptionFilterSchema) }), { auth: "admin" }), method(ListCandidatesInputSchema, ListCandidatesOutputSchema, { auth: "admin" }), method(GetCandidateInputSchema, DiscoveredChildDeviceSchema.nullable(), { auth: "admin" }), method(object({ integrationId: string() }), AdoptionStatusSchema, {
 	kind: "mutation",
@@ -13839,6 +13890,11 @@ var DeviceMetaSchema = object({
 	addonId: string(),
 	type: string(),
 	name: string(),
+	/** True once an operator explicitly renamed the device via `setName`. Drives
+	*  reconcile name-precedence (preserve operator name vs adopt fresh provider
+	*  name). Absent ⇒ treated as user-named (PRESERVE) for legacy rows. See
+	*  `DeviceMeta.userNamed`. */
+	userNamed: boolean().optional(),
 	location: string().nullable(),
 	disabled: boolean(),
 	parentDeviceId: number().nullable(),
@@ -14149,6 +14205,9 @@ method(object({
 }), method(ReleaseInputSchema.extend({ addonId: string() }), _void(), {
 	kind: "mutation",
 	auth: "admin"
+}), method(ResyncInputSchema, ResyncResultSchema, {
+	kind: "mutation",
+	auth: "admin"
 }), method(object({
 	deviceId: number(),
 	key: string(),
@@ -17911,6 +17970,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.adoptionResync": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"deviceManager.allocateDeviceId": {
 		capName: "device-manager",
 		capScope: "system",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-mqtt-broker",
-  "version": "1.1.7",
+  "version": "1.1.8",
   "description": "MQTT broker registry addon for CamStack — manages external broker entries + an optional embedded aedes broker. Consumers spin up their own `mqtt.js` clients via the `mqtt-broker` cap.",
   "keywords": [
     "camstack",