@camstack/addon-provider-dreame 0.1.15 → 0.1.17

package/dist/addon.js

@@ -4680,7 +4680,7 @@ function preprocess(fn, schema) {
 	});
 }
 //#endregion
-//#region ../types/dist/sleep-B3AOslwX.mjs
+//#region ../types/dist/sleep-C2M2zF7x.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -6248,6 +6248,12 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
 	DeviceType["Switch"] = "switch";
 	DeviceType["Sensor"] = "sensor";
 	DeviceType["Thermostat"] = "thermostat";
+	/** Air-conditioner / heat-pump climate device (HVAC) — shares the
+	*  `climate-control` cap surface with `Thermostat` but renders a
+	*  dedicated AC-appropriate control UI (mode chips, fan speed,
+	*  independent vertical/horizontal swing). Sources: native Gree, and
+	*  reusable by other AC integrations. */
+	DeviceType["Climate"] = "climate";
 	DeviceType["Button"] = "button";
 	/** Generic stateless event emitter — carries a device's EXACT declared
 	*  event vocabulary verbatim (no normalization). Installed with the
@@ -9043,7 +9049,7 @@ var climateControlCapability = {
 	scope: "device",
 	deviceNative: true,
 	mode: "singleton",
-	deviceTypes: [DeviceType.Thermostat],
+	deviceTypes: [DeviceType.Thermostat, DeviceType.Climate],
 	methods: {
 		setMode: method(object({
 			deviceId: number().int().nonnegative(),
@@ -13642,10 +13648,30 @@ var deviceProviderCapability = {
 			type: string()
 		}))),
 		supportsDiscovery: method(object({}), boolean()),
-		discoverDevices: method(object({}), array(DiscoveryCandidateSchema), {
+		/**
+		* Run a network scan. `params` carries optional provider-specific scan
+		* inputs (e.g. a broadcast address / subnet for cross-subnet discovery),
+		* shaped by `getDiscoveryParamsSchema`. Omitted for the generic scan
+		* (provider uses its local-network default).
+		*/
+		discoverDevices: method(object({ params: record(string(), unknown()).optional() }), array(DiscoveryCandidateSchema), {
 			kind: "mutation",
 			auth: "admin"
 		}),
+		/**
+		* Optional form schema (`ConfigUISchema`) for the EXTRA per-scan inputs a
+		* provider accepts (e.g. Gree's broadcast address for a different subnet).
+		* `null` when the provider takes no extra scan params — the generic
+		* aggregated scan never renders this; the per-integration scan does.
+		*/
+		getDiscoveryParamsSchema: method(object({}), CreationSchemaOutputSchema),
+		/**
+		* The DeviceType this provider creates via manual add (Camera for
+		* Reolink/ONVIF, Container for Gree, Hub for Ecowitt). `null` when the
+		* provider does not support manual creation. Lets the Add-Device dialog
+		* pick the right type instead of assuming Camera.
+		*/
+		getManualCreationType: method(object({}), object({ deviceType: _enum(DeviceType).nullable() })),
 		adoptDiscoveredDevice: method(object({ candidate: DiscoveryCandidateSchema }), DeviceSummarySchema, {
 			kind: "mutation",
 			auth: "admin"
@@ -13769,9 +13795,23 @@ var BaseDeviceProvider = class extends BaseAddon {
 	async supportsDiscovery() {
 		return false;
 	}
-	async discoverDevices() {
+	async discoverDevices(_input) {
 		return [];
 	}
+	/** Extra per-scan input form (e.g. a broadcast address for another subnet).
+	*  Null = no extra params. Override in providers that support scoped scans. */
+	async getDiscoveryParamsSchema() {
+		return null;
+	}
+	/**
+	* The DeviceType this provider creates via manual add — derived from the
+	* `deviceClasses` map (first registered type). `null` when manual creation is
+	* unsupported. Lets the Add-Device dialog pick the right type per provider.
+	*/
+	async getManualCreationType() {
+		if (!await this.supportsManualCreation()) return { deviceType: null };
+		return { deviceType: Object.values(DeviceType).find((t) => this.deviceClasses[t] !== void 0) ?? null };
+	}
 	async adoptDiscoveredDevice(_input) {
 		throw new Error(`${this.providerName} provider does not support discovery-based adoption`);
 	}
@@ -15633,7 +15673,10 @@ method(object({
 }), FieldProbeResultSchema, {
 	kind: "mutation",
 	auth: "admin"
-}), method(ListCandidatesInputSchema.extend({ addonId: string() }), ListCandidatesOutputSchema, { auth: "admin" }), method(object({
+}), method(object({
+	addonId: string(),
+	integrationId: string()
+}), object({ filters: array(AdoptionFilterSchema) }), { auth: "admin" }), method(ListCandidatesInputSchema.extend({ addonId: string() }), ListCandidatesOutputSchema, { auth: "admin" }), method(object({
 	addonId: string(),
 	integrationId: string()
 }), AdoptionStatusSchema, {
@@ -15648,7 +15691,24 @@ method(object({
 }), method(ResyncInputSchema, ResyncResultSchema, {
 	kind: "mutation",
 	auth: "admin"
+}), method(object({}), object({ providers: array(object({
+	addonId: string(),
+	label: string()
+})).readonly() }), { auth: "admin" }), method(object({}), object({ groups: array(object({
+	addonId: string(),
+	label: string(),
+	candidates: array(DiscoveryCandidateSchema).readonly(),
+	error: string().nullable()
+})).readonly() }), {
+	kind: "mutation",
+	auth: "admin"
 }), method(object({
+	addonId: string(),
+	params: record(string(), unknown()).optional()
+}), object({ candidates: array(DiscoveryCandidateSchema).readonly() }), {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({ addonId: string() }), object({ deviceType: _enum(DeviceType).nullable() }), { auth: "admin" }), method(object({ addonId: string() }), unknown(), { auth: "admin" }), method(object({
 	deviceId: number(),
 	key: string(),
 	value: unknown()
@@ -20788,6 +20848,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.adoptionListCandidateFilters": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.adoptionListCandidates": {
 		capName: "device-manager",
 		capScope: "system",
@@ -20836,12 +20902,30 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.discoverAllProviders": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"deviceManager.discoverDevices": {
 		capName: "device-manager",
 		capScope: "system",
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.discoverProvider": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
+	"deviceManager.discoveryProviders": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.enable": {
 		capName: "device-manager",
 		capScope: "system",
@@ -20992,6 +21076,18 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.providerCreationType": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
+	"deviceManager.providerDiscoveryParamsSchema": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.registerDevice": {
 		capName: "device-manager",
 		capScope: "system",
@@ -21208,6 +21304,18 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"deviceProvider.getDiscoveryParamsSchema": {
+		capName: "device-provider",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
+	"deviceProvider.getManualCreationType": {
+		capName: "device-provider",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceProvider.getStatus": {
 		capName: "device-provider",
 		capScope: "system",
@@ -75112,6 +75220,34 @@ function enumOptions(e) {
 		label: humanizeEnumName(name)
 	}));
 }
+/**
+* MiotError codes that are BENIGN completion / reminder states, not active
+* faults. HA does not surface these as errors — a fresh cloud-shadow read of an
+* idle docked robot legitimately returns `TaskComplete` (68). We relabel them to
+* the `Clear` label so the Error sensor only shows real faults (HA parity).
+* Extend this set if other non-fault codes surface as spurious "errors".
+*/
+var BENIGN_ERROR_CODES = new Set([MiotError.TaskComplete]);
+/** `MiotError` options with the benign completion codes remapped to the `Clear`
+*  label, so the Error sensor reads as no-error for them (matches HA). */
+function errorEnumOptions() {
+	const clearLabel = humanizeEnumName(MiotError[MiotError.Clear]);
+	return enumOptions(MiotError).map((o) => BENIGN_ERROR_CODES.has(o.value) ? {
+		...o,
+		label: clearLabel
+	} : o);
+}
+/**
+* Resolve the CURRENT catalog options for an enum-sensor by its MIoT coordinates
+* (across both the vacuum and mower enum-sensor catalogs). The enum-sensor child
+* persists its option map at adoption; preferring the live catalog here lets a
+* label change (e.g. the benign-error remap) take effect for already-adopted
+* children on the next boot — without a re-adopt. Null when no catalog entry
+* matches (persisted config is then the only source).
+*/
+function enumSensorOptionsFor(siid, piid) {
+	return [...DREAME_ENUM_SENSORS, ...DREAME_MOWER_ENUM_SENSORS].find((es) => es.siid === siid && es.piid === piid)?.options ?? null;
+}
 /** Humanise a Tasshack SNAKE_CASE enum name → spaced Title Case
 *  ('BACK_HOME' → 'Back Home'). */
 function humanizeSnake(name) {
@@ -75237,7 +75373,7 @@ var DREAME_ENUM_SENSORS = [
 		label: "Error",
 		siid: 2,
 		piid: 2,
-		options: enumOptions(MiotError),
+		options: errorEnumOptions(),
 		section: DIAG
 	},
 	{
@@ -76964,7 +77100,7 @@ var DreameEnumSensorDevice = class extends DreameChildDevice {
 		const cfg = dreameEnumSensorSchema.parse(ctx.persistedConfig ?? {});
 		this.#siid = cfg.siid;
 		this.#piid = cfg.piid;
-		this.#options = cfg.options;
+		this.#options = enumSensorOptionsFor(cfg.siid, cfg.piid) ?? cfg.options;
 		this.updateSourceInfo({
 			id: `${this.dreameDeviceId}:enum:${cfg.siid}-${cfg.piid}`,
 			system: "dreame"
@@ -77214,6 +77350,15 @@ var CONSUMABLES_CAP_NAME$1 = "consumables";
 var CONSUMABLES_WAKE_RETRIES = 2;
 /** Spacing between wake-window retries. */
 var CONSUMABLES_RETRY_DELAY_MS = 1500;
+/**
+* Cloud-shadow (no-wake) refresh cadence for the mower's battery / charging /
+* status props. The shadow read (`refreshFromCache` → `getCachedProperties`)
+* hits the cloud SHADOW, not the device — so it succeeds even while the mower
+* sleeps at base, UNLIKE the synchronous CMS action above (which 80001s). The
+* mower never PUSHES battery over MQTT, so without this poll `batteryLevel`
+* stays null. A gentle interval keeps the level current as it charges.
+*/
+var SHADOW_POLL_MS = 12e4;
 var COLD_START = {
 	activity: "idle",
 	batteryLevel: null,
@@ -77253,6 +77398,8 @@ var DreameMowerDevice = class extends DreameChildDevice {
 	#prevStatus = null;
 	/** Last seen `chargingStatus` value — second awake-and-charging trigger. */
 	#prevCharging = null;
+	/** Periodic cloud-shadow refresh timer (battery / charging / status). */
+	#shadowTimer = null;
 	constructor(ctx) {
 		super(ctx);
 	}
@@ -77288,6 +77435,35 @@ var DreameMowerDevice = class extends DreameChildDevice {
 	async onActivate() {
 		await super.onActivate();
 		this.refreshConsumables(CONSUMABLES_WAKE_RETRIES);
+		this.#refreshShadow();
+		this.#shadowTimer = setInterval(() => {
+			this.#refreshShadow();
+		}, SHADOW_POLL_MS);
+	}
+	async removeDevice() {
+		if (this.#shadowTimer) {
+			clearInterval(this.#shadowTimer);
+			this.#shadowTimer = null;
+		}
+		await super.removeDevice();
+	}
+	/**
+	* Seed the cached MIoT props (battery / charging / status …) from the CLOUD
+	* SHADOW — a no-wake read that succeeds even while the mower sleeps at base.
+	* `refreshFromCache` emits `stateChanged`, which drives `recomputeSlice`, so
+	* the battery level lands in the slice. Best-effort; failures log at debug.
+	*/
+	async #refreshShadow() {
+		const mower = this.resolveMower();
+		if (mower === null) return;
+		try {
+			await mower.refreshFromCache();
+		} catch (err) {
+			this.ctx.logger.debug("dreame mower: cloud-shadow refresh failed", { meta: {
+				dreameDeviceId: this.dreameDeviceId,
+				error: errMsg(err)
+			} });
+		}
 	}
 	recomputeSlice() {
 		const mower = this.resolveMower();

package/dist/addon.mjs

@@ -4680,7 +4680,7 @@ function preprocess(fn, schema) {
 	});
 }
 //#endregion
-//#region ../types/dist/sleep-B3AOslwX.mjs
+//#region ../types/dist/sleep-C2M2zF7x.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -6248,6 +6248,12 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
 	DeviceType["Switch"] = "switch";
 	DeviceType["Sensor"] = "sensor";
 	DeviceType["Thermostat"] = "thermostat";
+	/** Air-conditioner / heat-pump climate device (HVAC) — shares the
+	*  `climate-control` cap surface with `Thermostat` but renders a
+	*  dedicated AC-appropriate control UI (mode chips, fan speed,
+	*  independent vertical/horizontal swing). Sources: native Gree, and
+	*  reusable by other AC integrations. */
+	DeviceType["Climate"] = "climate";
 	DeviceType["Button"] = "button";
 	/** Generic stateless event emitter — carries a device's EXACT declared
 	*  event vocabulary verbatim (no normalization). Installed with the
@@ -9043,7 +9049,7 @@ var climateControlCapability = {
 	scope: "device",
 	deviceNative: true,
 	mode: "singleton",
-	deviceTypes: [DeviceType.Thermostat],
+	deviceTypes: [DeviceType.Thermostat, DeviceType.Climate],
 	methods: {
 		setMode: method(object({
 			deviceId: number().int().nonnegative(),
@@ -13642,10 +13648,30 @@ var deviceProviderCapability = {
 			type: string()
 		}))),
 		supportsDiscovery: method(object({}), boolean()),
-		discoverDevices: method(object({}), array(DiscoveryCandidateSchema), {
+		/**
+		* Run a network scan. `params` carries optional provider-specific scan
+		* inputs (e.g. a broadcast address / subnet for cross-subnet discovery),
+		* shaped by `getDiscoveryParamsSchema`. Omitted for the generic scan
+		* (provider uses its local-network default).
+		*/
+		discoverDevices: method(object({ params: record(string(), unknown()).optional() }), array(DiscoveryCandidateSchema), {
 			kind: "mutation",
 			auth: "admin"
 		}),
+		/**
+		* Optional form schema (`ConfigUISchema`) for the EXTRA per-scan inputs a
+		* provider accepts (e.g. Gree's broadcast address for a different subnet).
+		* `null` when the provider takes no extra scan params — the generic
+		* aggregated scan never renders this; the per-integration scan does.
+		*/
+		getDiscoveryParamsSchema: method(object({}), CreationSchemaOutputSchema),
+		/**
+		* The DeviceType this provider creates via manual add (Camera for
+		* Reolink/ONVIF, Container for Gree, Hub for Ecowitt). `null` when the
+		* provider does not support manual creation. Lets the Add-Device dialog
+		* pick the right type instead of assuming Camera.
+		*/
+		getManualCreationType: method(object({}), object({ deviceType: _enum(DeviceType).nullable() })),
 		adoptDiscoveredDevice: method(object({ candidate: DiscoveryCandidateSchema }), DeviceSummarySchema, {
 			kind: "mutation",
 			auth: "admin"
@@ -13769,9 +13795,23 @@ var BaseDeviceProvider = class extends BaseAddon {
 	async supportsDiscovery() {
 		return false;
 	}
-	async discoverDevices() {
+	async discoverDevices(_input) {
 		return [];
 	}
+	/** Extra per-scan input form (e.g. a broadcast address for another subnet).
+	*  Null = no extra params. Override in providers that support scoped scans. */
+	async getDiscoveryParamsSchema() {
+		return null;
+	}
+	/**
+	* The DeviceType this provider creates via manual add — derived from the
+	* `deviceClasses` map (first registered type). `null` when manual creation is
+	* unsupported. Lets the Add-Device dialog pick the right type per provider.
+	*/
+	async getManualCreationType() {
+		if (!await this.supportsManualCreation()) return { deviceType: null };
+		return { deviceType: Object.values(DeviceType).find((t) => this.deviceClasses[t] !== void 0) ?? null };
+	}
 	async adoptDiscoveredDevice(_input) {
 		throw new Error(`${this.providerName} provider does not support discovery-based adoption`);
 	}
@@ -15633,7 +15673,10 @@ method(object({
 }), FieldProbeResultSchema, {
 	kind: "mutation",
 	auth: "admin"
-}), method(ListCandidatesInputSchema.extend({ addonId: string() }), ListCandidatesOutputSchema, { auth: "admin" }), method(object({
+}), method(object({
+	addonId: string(),
+	integrationId: string()
+}), object({ filters: array(AdoptionFilterSchema) }), { auth: "admin" }), method(ListCandidatesInputSchema.extend({ addonId: string() }), ListCandidatesOutputSchema, { auth: "admin" }), method(object({
 	addonId: string(),
 	integrationId: string()
 }), AdoptionStatusSchema, {
@@ -15648,7 +15691,24 @@ method(object({
 }), method(ResyncInputSchema, ResyncResultSchema, {
 	kind: "mutation",
 	auth: "admin"
+}), method(object({}), object({ providers: array(object({
+	addonId: string(),
+	label: string()
+})).readonly() }), { auth: "admin" }), method(object({}), object({ groups: array(object({
+	addonId: string(),
+	label: string(),
+	candidates: array(DiscoveryCandidateSchema).readonly(),
+	error: string().nullable()
+})).readonly() }), {
+	kind: "mutation",
+	auth: "admin"
 }), method(object({
+	addonId: string(),
+	params: record(string(), unknown()).optional()
+}), object({ candidates: array(DiscoveryCandidateSchema).readonly() }), {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({ addonId: string() }), object({ deviceType: _enum(DeviceType).nullable() }), { auth: "admin" }), method(object({ addonId: string() }), unknown(), { auth: "admin" }), method(object({
 	deviceId: number(),
 	key: string(),
 	value: unknown()
@@ -20788,6 +20848,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.adoptionListCandidateFilters": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.adoptionListCandidates": {
 		capName: "device-manager",
 		capScope: "system",
@@ -20836,12 +20902,30 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.discoverAllProviders": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"deviceManager.discoverDevices": {
 		capName: "device-manager",
 		capScope: "system",
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.discoverProvider": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
+	"deviceManager.discoveryProviders": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.enable": {
 		capName: "device-manager",
 		capScope: "system",
@@ -20992,6 +21076,18 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.providerCreationType": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
+	"deviceManager.providerDiscoveryParamsSchema": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.registerDevice": {
 		capName: "device-manager",
 		capScope: "system",
@@ -21208,6 +21304,18 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"deviceProvider.getDiscoveryParamsSchema": {
+		capName: "device-provider",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
+	"deviceProvider.getManualCreationType": {
+		capName: "device-provider",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceProvider.getStatus": {
 		capName: "device-provider",
 		capScope: "system",
@@ -75112,6 +75220,34 @@ function enumOptions(e) {
 		label: humanizeEnumName(name)
 	}));
 }
+/**
+* MiotError codes that are BENIGN completion / reminder states, not active
+* faults. HA does not surface these as errors — a fresh cloud-shadow read of an
+* idle docked robot legitimately returns `TaskComplete` (68). We relabel them to
+* the `Clear` label so the Error sensor only shows real faults (HA parity).
+* Extend this set if other non-fault codes surface as spurious "errors".
+*/
+var BENIGN_ERROR_CODES = new Set([MiotError.TaskComplete]);
+/** `MiotError` options with the benign completion codes remapped to the `Clear`
+*  label, so the Error sensor reads as no-error for them (matches HA). */
+function errorEnumOptions() {
+	const clearLabel = humanizeEnumName(MiotError[MiotError.Clear]);
+	return enumOptions(MiotError).map((o) => BENIGN_ERROR_CODES.has(o.value) ? {
+		...o,
+		label: clearLabel
+	} : o);
+}
+/**
+* Resolve the CURRENT catalog options for an enum-sensor by its MIoT coordinates
+* (across both the vacuum and mower enum-sensor catalogs). The enum-sensor child
+* persists its option map at adoption; preferring the live catalog here lets a
+* label change (e.g. the benign-error remap) take effect for already-adopted
+* children on the next boot — without a re-adopt. Null when no catalog entry
+* matches (persisted config is then the only source).
+*/
+function enumSensorOptionsFor(siid, piid) {
+	return [...DREAME_ENUM_SENSORS, ...DREAME_MOWER_ENUM_SENSORS].find((es) => es.siid === siid && es.piid === piid)?.options ?? null;
+}
 /** Humanise a Tasshack SNAKE_CASE enum name → spaced Title Case
 *  ('BACK_HOME' → 'Back Home'). */
 function humanizeSnake(name) {
@@ -75237,7 +75373,7 @@ var DREAME_ENUM_SENSORS = [
 		label: "Error",
 		siid: 2,
 		piid: 2,
-		options: enumOptions(MiotError),
+		options: errorEnumOptions(),
 		section: DIAG
 	},
 	{
@@ -76964,7 +77100,7 @@ var DreameEnumSensorDevice = class extends DreameChildDevice {
 		const cfg = dreameEnumSensorSchema.parse(ctx.persistedConfig ?? {});
 		this.#siid = cfg.siid;
 		this.#piid = cfg.piid;
-		this.#options = cfg.options;
+		this.#options = enumSensorOptionsFor(cfg.siid, cfg.piid) ?? cfg.options;
 		this.updateSourceInfo({
 			id: `${this.dreameDeviceId}:enum:${cfg.siid}-${cfg.piid}`,
 			system: "dreame"
@@ -77214,6 +77350,15 @@ var CONSUMABLES_CAP_NAME$1 = "consumables";
 var CONSUMABLES_WAKE_RETRIES = 2;
 /** Spacing between wake-window retries. */
 var CONSUMABLES_RETRY_DELAY_MS = 1500;
+/**
+* Cloud-shadow (no-wake) refresh cadence for the mower's battery / charging /
+* status props. The shadow read (`refreshFromCache` → `getCachedProperties`)
+* hits the cloud SHADOW, not the device — so it succeeds even while the mower
+* sleeps at base, UNLIKE the synchronous CMS action above (which 80001s). The
+* mower never PUSHES battery over MQTT, so without this poll `batteryLevel`
+* stays null. A gentle interval keeps the level current as it charges.
+*/
+var SHADOW_POLL_MS = 12e4;
 var COLD_START = {
 	activity: "idle",
 	batteryLevel: null,
@@ -77253,6 +77398,8 @@ var DreameMowerDevice = class extends DreameChildDevice {
 	#prevStatus = null;
 	/** Last seen `chargingStatus` value — second awake-and-charging trigger. */
 	#prevCharging = null;
+	/** Periodic cloud-shadow refresh timer (battery / charging / status). */
+	#shadowTimer = null;
 	constructor(ctx) {
 		super(ctx);
 	}
@@ -77288,6 +77435,35 @@ var DreameMowerDevice = class extends DreameChildDevice {
 	async onActivate() {
 		await super.onActivate();
 		this.refreshConsumables(CONSUMABLES_WAKE_RETRIES);
+		this.#refreshShadow();
+		this.#shadowTimer = setInterval(() => {
+			this.#refreshShadow();
+		}, SHADOW_POLL_MS);
+	}
+	async removeDevice() {
+		if (this.#shadowTimer) {
+			clearInterval(this.#shadowTimer);
+			this.#shadowTimer = null;
+		}
+		await super.removeDevice();
+	}
+	/**
+	* Seed the cached MIoT props (battery / charging / status …) from the CLOUD
+	* SHADOW — a no-wake read that succeeds even while the mower sleeps at base.
+	* `refreshFromCache` emits `stateChanged`, which drives `recomputeSlice`, so
+	* the battery level lands in the slice. Best-effort; failures log at debug.
+	*/
+	async #refreshShadow() {
+		const mower = this.resolveMower();
+		if (mower === null) return;
+		try {
+			await mower.refreshFromCache();
+		} catch (err) {
+			this.ctx.logger.debug("dreame mower: cloud-shadow refresh failed", { meta: {
+				dreameDeviceId: this.dreameDeviceId,
+				error: errMsg(err)
+			} });
+		}
 	}
 	recomputeSlice() {
 		const mower = this.resolveMower();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-dreame",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "Dreame robot-vacuum / lawn-mower device-provider addon for CamStack — wraps the @apocaliss92/nodedreame Dreamehome cloud client",
   "keywords": [
     "camstack",