@camstack/addon-provider-dreame 0.2.106 → 0.2.108

package/dist/addon.js

@@ -46670,6 +46670,22 @@ objectType({
 	msg: stringType().nullish(),
 	data: objectType({ data: objectType({ familyId: stringType() }).passthrough() }).passthrough()
 }).passthrough();
+objectType({
+	code: numberType().optional(),
+	msg: stringType().nullish(),
+	data: objectType({ data: objectType({
+		productId: stringType(),
+		deviceName: stringType(),
+		deviceId: stringType().optional(),
+		secretId: stringType().optional(),
+		secretKey: stringType().optional()
+	}).passthrough() }).passthrough()
+}).passthrough();
+objectType({
+	code: numberType().optional(),
+	msg: stringType().nullish(),
+	data: objectType({ data: objectType({ p2pInfo: stringType() }).passthrough() }).passthrough()
+}).passthrough();
 var DeviceVideoInfoSchema = objectType({
 	model: stringType().optional(),
 	displayName: stringType().optional(),
@@ -47129,6 +47145,15 @@ var DreameVideoSession = class {
 		return (await this.getStreamInfo(iotId, { encrypted: false })).relayUrl;
 	}
 };
+function explainNoCameraChannel(profile) {
+	if (profile.iotId) return null;
+	const who = `${profile.model || "unknown model"} (${profile.did || "no did"})`;
+	if (!profile.videoCapable) return `${who} is not a camera: the cloud lists no video permit and no supported video vendor for it, so there is no channel to open.`;
+	if (!profile.online) return `${who} is a camera but is OFFLINE. The video binding is published by the device itself, so there is nothing to read until it connects \u2014 this is not a provisioning fault.`;
+	const supports = profile.supportedVendors.length > 0 ? profile.supportedVendors.join(", ") : "none";
+	if (profile.currentVendor === "tx") return `${who} is a camera and online, but is provisioned on the TENCENT video vendor (vendor: tx; supports: ${supports}), and this library implements only the Aliyun LinkVisual path \u2014 the channel id it needs lives on Aliyun and a tx device has none. Re-pairing or re-opening the camera in the app will not change this.`;
+	return `${who} is a camera and online, but has no video channel yet (vendor: ${profile.currentVendor ?? "none"}; supports: ${supports}). The device has not bound to the video service \u2014 open its camera once in the Dreame app to create the binding, then retry.`;
+}
 var MONITOR_SIID = 10001;
 var MONITOR_AIID = {
 	/** Stream lifecycle + keep-alive (monitor start/end, keep_alive). */
@@ -47322,6 +47347,33 @@ function firstOutValue(res) {
 	const out = r?.out ?? r?.result?.out;
 	return Array.isArray(out) && out.length > 0 ? out[0]?.value : void 0;
 }
+function videoVendorSwitchParams(vendor) {
+	return { vendor };
+}
+function parseVideoVendorStatus(raw) {
+	const text = typeof raw === "string" ? raw : typeof raw === "object" && raw !== null ? null : null;
+	const source = text === null ? raw : safeJson(text);
+	if (typeof source !== "object" || source === null) return {
+		vendor: null,
+		initStatus: null
+	};
+	const v = Reflect.get(source, "vendor");
+	const s = Reflect.get(source, "initStatus");
+	return {
+		vendor: v === "ali" || v === "tx" ? v : null,
+		initStatus: typeof s === "number" ? s : null
+	};
+}
+function safeJson(text) {
+	try {
+		return JSON.parse(text);
+	} catch {
+		return null;
+	}
+}
+function vendorSwitchSettled(status, wanted) {
+	return status.vendor === wanted && status.initStatus === 1;
+}
 var DEFAULT_KEEP_ALIVE_MS = 1e4;
 var DEFAULT_AREA = "4";
 var DreameCameraController = class {
@@ -50181,12 +50233,16 @@ var VacuumDevice = class _VacuumDevice extends BaseDevice$1 {
 			session,
 			region
 		});
-		const iotId = opts?.iotId ?? (await getDeviceVideoProfile({
-			session,
-			region,
-			did: this.deviceId
-		})).iotId;
-		if (!iotId) throw new DreameError("device has no LinkVisual iotId; not a camera device or not provisioned");
+		let iotId = opts?.iotId ?? null;
+		if (!iotId) {
+			const profile = await getDeviceVideoProfile({
+				session,
+				region,
+				did: this.deviceId
+			});
+			iotId = profile.iotId;
+			if (!iotId) throw new DreameError(explainNoCameraChannel(profile) ?? "device has no video channel");
+		}
 		return new DreameCameraController({
 			device: this,
 			relay,
@@ -50201,6 +50257,54 @@ var VacuumDevice = class _VacuumDevice extends BaseDevice$1 {
 			...opts?.log ? { log: opts.log } : {}
 		});
 	}
+	/**
+	* What video backend this robot is on, and whether that backend's SDK is up.
+	*
+	* A CACHED read by default: the cloud shadow answers for a robot on its dock
+	* without waking it, which is the whole point of asking before deciding how
+	* to stream. Pass `{ live: true }` when the answer must be current — while a
+	* switch settles, for instance.
+	*/
+	async readVideoVendorStatus(opts) {
+		const props = [{
+			siid: MONITOR_SIID,
+			piid: MONITOR_PIID.VIDEO_VENDOR_STATUS
+		}];
+		return parseVideoVendorStatus((opts?.live === true ? await this.refreshProperties(props) : await this.refreshCachedProperties(props))[0]?.value);
+	}
+	/**
+	* Move this robot onto a video backend, and WAIT until it is really there.
+	*
+	* The two backends are not interchangeable: measured on an X50 on
+	* 2026-09-16, a robot on `tx` offers only Tencent's proprietary UDP P2P
+	* plane (`getRtcInfo` answers 404), while the same robot on `ali` streams
+	* through a plain RTMP relay this library implements end to end. So which
+	* one it sits on decides whether it can be streamed at all.
+	*
+	* The device reports the NEW vendor before its SDK is up, which is why the
+	* app polls rather than trusting the action's return — and why this resolves
+	* on `initStatus === 1` and not a moment earlier. A half-switched robot
+	* answers questions about a backend it cannot yet serve.
+	*
+	* Only meaningful on a dual-vendor device (`videoDynamicVendor`, with the
+	* target in `defaultVendors`); a device that cannot move simply never
+	* settles, and this reports that as a timeout rather than a silent success.
+	*/
+	async setVideoVendor(vendor, opts) {
+		const already = await this.readVideoVendorStatus({ live: true });
+		if (vendorSwitchSettled(already, vendor)) return already;
+		const session = makeMonitorSession(this.currentSession().uid);
+		await this.callAction(MONITOR_SIID, MONITOR_AIID.VIDEO_VENDOR, [buildActionInput(MONITOR_PIID.VIDEO_VENDOR_STATUS, videoVendorSwitchParams(vendor), session)]);
+		const every = opts?.pollIntervalMs ?? 5e3;
+		const deadline = Date.now() + (opts?.timeoutMs ?? every * 10);
+		let last = already;
+		while (Date.now() < deadline) {
+			await new Promise((r) => setTimeout(r, every));
+			last = await this.readVideoVendorStatus({ live: true });
+			if (vendorSwitchSettled(last, vendor)) return last;
+		}
+		throw new DreameError(`video vendor did not settle on "${vendor}" within the timeout (last seen: vendor=${last.vendor ?? "unknown"}, initStatus=${String(last.initStatus)})`);
+	}
 	/** Props worth seeding on start() / polling — exported for the facade. */
 	static DEFAULT_PROPS = [
 		VACUUM_PROP.STATE,
@@ -66169,6 +66273,107 @@ var ExposeInputSchema = object({
 });
 var UnexposeInputSchema = object({ deviceId: string() });
 method(_void(), DeviceExportStatusSchema), method(_void(), array(DeviceKindSchema)), method(_void(), array(ExposedDeviceSchema)), method(ExposeInputSchema, _void(), { kind: "mutation" }), method(UnexposeInputSchema, _void(), { kind: "mutation" });
+/** Wire/storage schema for one icon id. */
+var LocationIconIdSchema = _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 = object({
+	locationKey: string(),
+	icon: LocationIconIdSchema
+});
+/**
+* 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 = object({
+	locationKey: string(),
+	description: 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 = object({
+	zoneKey: string(),
+	label: 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: array(string())
+});
 var ProviderStatusSchema = object({
 	connected: boolean(),
 	deviceCount: number(),
@@ -66761,6 +66966,39 @@ method(object({
 }), object({ moved: number() }), {
 	kind: "mutation",
 	auth: "admin"
+}), method(_void(), array(LocationIconAssignmentSchema)), method(object({
+	location: string(),
+	icon: LocationIconIdSchema.nullable()
+}), _void(), {
+	kind: "mutation",
+	auth: "admin"
+}), method(_void(), array(LocationDescriptionAssignmentSchema)), method(object({
+	location: string(),
+	description: string().max(400).nullable()
+}), _void(), {
+	kind: "mutation",
+	auth: "admin"
+}), method(_void(), array(SiteZoneSchema)), method(object({
+	name: string(),
+	icon: LocationIconIdSchema.nullable().optional()
+}), _void(), {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({ name: string() }), _void(), {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({
+	from: string(),
+	to: string()
+}), _void(), {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({
+	location: string(),
+	zone: string().nullable()
+}), _void(), {
+	kind: "mutation",
+	auth: "admin"
 }), method(object({
 	deviceId: number(),
 	disabled: boolean()
@@ -89844,6 +90082,18 @@ 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",
@@ -89856,6 +90106,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"deviceManager.listSiteZones": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.listWrappersForCap": {
 		capName: "device-manager",
 		capScope: "system",
@@ -89940,12 +90196,24 @@ 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",
@@ -89988,6 +90256,24 @@ 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",
@@ -90018,6 +90304,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.setSiteZone": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"deviceManager.setStreamProfileMap": {
 		capName: "device-manager",
 		capScope: "system",
@@ -98763,6 +99055,15 @@ var dreameChildSchema = object({
 	/** Privacy PIN set at pairing — required to wake a coded camera (camera child only). */
 	navigationAccessCode: string().optional(),
 	/**
+	* The video backend the robot should sit on (camera child only).
+	*
+	* Not a preference the addon enforces: it is written THROUGH to the device
+	* by `applySettingsPatch`, and the device is the authority on where it
+	* actually is. Stored so the settings form has a value to show before the
+	* first read answers.
+	*/
+	videoVendor: _enum(["ali", "tx"]).optional(),
+	/**
 	* ms-epoch of the ONE-SHOT recording seed (camera child only, D380).
 	*
 	* A MARK, never the value: it says this camera was seeded, which stays true
@@ -145673,6 +145974,58 @@ function navigationSlice(prev, patch, now) {
 * for two separate things (admin UI: two tabs; viewer: one panel that shows the
 * navigation controls when the device has the cap).
 */
+/**
+* The camera child's settings form.
+*
+* A PURE export so the shape can be asserted without constructing a device —
+* the same discipline `navigationSlice` follows in this file. What matters
+* here is that the backend selector offers exactly the two vendors this
+* library can stream, in the order that puts the working one first.
+*/
+var CAMERA_SETTINGS_SCHEMA = { sections: [{
+	id: "camera-backend",
+	title: "Video backend",
+	description: "Which cloud video service this robot streams through. The two are not interchangeable: only the Aliyun path is implemented here — a robot on Tencent can be seen in the Dreame app but not by CamStack, because Tencent offers it a proprietary P2P plane we do not speak. Changing this asks the ROBOT to switch and waits until its SDK reports ready; the robot is the authority on where it actually is.",
+	fields: [{
+		type: "select",
+		key: "videoVendor",
+		label: "Backend",
+		description: "Aliyun streams through a plain relay and works today. Tencent is offered so the other path can be tested once it exists.",
+		options: [{
+			value: "ali",
+			label: "Aliyun LinkVisual (supported)"
+		}, {
+			value: "tx",
+			label: "Tencent IoT-Video (not implemented yet)"
+		}]
+	}]
+}, {
+	id: "camera-access",
+	title: "Camera access",
+	description: "The privacy code set when the robot camera was paired. The robot refuses to open its camera without it.",
+	fields: [{
+		type: "password",
+		key: "navigationAccessCode",
+		label: "Camera access code",
+		showToggle: true
+	}]
+}] };
+/**
+* The values the form opens with.
+*
+* The DEVICE wins: it is the authority on which backend it is on, and the
+* stored preference is only what the operator last asked for. Showing the
+* preference while the robot sits elsewhere would tell the operator the switch
+* had worked when it had not. Before the first read has answered there is
+* nothing to show but the preference, and an empty string when there is
+* neither — unknown, never a default that looks like a fact (D393).
+*/
+function cameraSettingsValues(input) {
+	return {
+		navigationAccessCode: input.accessCode ?? "",
+		videoVendor: input.vendorNow ?? input.storedVendor ?? ""
+	};
+}
 var DreameCameraDevice = class extends DreameChildDevice {
 	features = [DeviceFeature.BatteryOperated];
 	constructor(ctx) {
@@ -145748,6 +146101,31 @@ var DreameCameraDevice = class extends DreameChildDevice {
 		});
 	}
 	/** One reader of the robot's link, shared in shape with the vacuum's. */
+	/**
+	* Where the robot says its video backend is, as last read.
+	*
+	* The settings schema is built synchronously and this is a device read, so
+	* it is cached and refreshed in the background when the form is opened — the
+	* serve-and-revalidate discipline D224 describes.
+	*
+	* `null` means never read, which the form shows as the stored preference
+	* instead — unknown is not the same fact as "on ali" (D393).
+	*/
+	vendorNow = null;
+	/** Refresh {@link vendorNow}. Never throws: the settings page must open
+	*  whether or not the robot answered. */
+	async refreshVendorNow() {
+		const handle = this.resolveHandle();
+		if (!(handle instanceof VacuumDevice)) return;
+		try {
+			this.vendorNow = (await handle.readVideoVendorStatus({ live: true })).vendor;
+		} catch (err) {
+			this.ctx.logger.debug("robot camera: video backend read failed", {
+				tags: { deviceId: this.id },
+				meta: { error: errMsg(err) }
+			});
+		}
+	}
 	networkLink = new DreameNetworkLinkMonitor({
 		deviceId: this.id,
 		logger: this.ctx.logger,
@@ -146074,20 +146452,58 @@ var DreameCameraDevice = class extends DreameChildDevice {
 	* offers is a setting that does not exist.
 	*/
 	getSettingsUISchema() {
-		return hydrateSchema({ sections: [{
-			id: "camera-access",
-			title: "Camera access",
-			description: "The privacy code set when the robot camera was paired. The robot refuses to open its camera without it.",
-			fields: [{
-				type: "password",
-				key: "navigationAccessCode",
-				label: "Camera access code",
-				showToggle: true
-			}]
-		}] }, { navigationAccessCode: this.config.get("navigationAccessCode") ?? "" });
+		this.refreshVendorNow();
+		return hydrateSchema(CAMERA_SETTINGS_SCHEMA, cameraSettingsValues({
+			accessCode: this.config.get("navigationAccessCode"),
+			vendorNow: this.vendorNow,
+			storedVendor: this.config.get("videoVendor")
+		}));
 	}
 	async applySettingsPatch(patch) {
+		this.ctx.logger.info("robot camera: settings patch received", {
+			tags: { deviceId: this.id },
+			meta: {
+				keys: Object.keys(patch).sort(),
+				vendorNow: this.vendorNow
+			}
+		});
 		await super.applySettingsPatch(patch);
+		const wanted = patch["videoVendor"];
+		if ((wanted === "ali" || wanted === "tx") && wanted !== this.vendorNow) {
+			const handle = this.resolveHandle();
+			if (handle instanceof VacuumDevice) {
+				await this.closeStream("removed");
+				this.controller = null;
+				this.controllerHandle = null;
+				this.ctx.logger.info("robot camera: switching video backend", {
+					tags: { deviceId: this.id },
+					meta: {
+						from: this.vendorNow,
+						to: wanted
+					}
+				});
+				try {
+					const settled = await handle.setVideoVendor(wanted);
+					this.vendorNow = settled.vendor;
+					this.ctx.logger.info("robot camera: video backend switched", {
+						tags: { deviceId: this.id },
+						meta: {
+							vendor: settled.vendor,
+							initStatus: settled.initStatus
+						}
+					});
+				} catch (err) {
+					this.ctx.logger.warn("robot camera: video backend switch refused", {
+						tags: { deviceId: this.id },
+						meta: {
+							to: wanted,
+							error: errMsg(err)
+						}
+					});
+					throw err;
+				}
+			}
+		}
 		if (!("navigationAccessCode" in patch)) return;
 		await this.closeStream("removed");
 		this.controller = null;

package/dist/addon.mjs

@@ -46667,6 +46667,22 @@ objectType({
 	msg: stringType().nullish(),
 	data: objectType({ data: objectType({ familyId: stringType() }).passthrough() }).passthrough()
 }).passthrough();
+objectType({
+	code: numberType().optional(),
+	msg: stringType().nullish(),
+	data: objectType({ data: objectType({
+		productId: stringType(),
+		deviceName: stringType(),
+		deviceId: stringType().optional(),
+		secretId: stringType().optional(),
+		secretKey: stringType().optional()
+	}).passthrough() }).passthrough()
+}).passthrough();
+objectType({
+	code: numberType().optional(),
+	msg: stringType().nullish(),
+	data: objectType({ data: objectType({ p2pInfo: stringType() }).passthrough() }).passthrough()
+}).passthrough();
 var DeviceVideoInfoSchema = objectType({
 	model: stringType().optional(),
 	displayName: stringType().optional(),
@@ -47126,6 +47142,15 @@ var DreameVideoSession = class {
 		return (await this.getStreamInfo(iotId, { encrypted: false })).relayUrl;
 	}
 };
+function explainNoCameraChannel(profile) {
+	if (profile.iotId) return null;
+	const who = `${profile.model || "unknown model"} (${profile.did || "no did"})`;
+	if (!profile.videoCapable) return `${who} is not a camera: the cloud lists no video permit and no supported video vendor for it, so there is no channel to open.`;
+	if (!profile.online) return `${who} is a camera but is OFFLINE. The video binding is published by the device itself, so there is nothing to read until it connects \u2014 this is not a provisioning fault.`;
+	const supports = profile.supportedVendors.length > 0 ? profile.supportedVendors.join(", ") : "none";
+	if (profile.currentVendor === "tx") return `${who} is a camera and online, but is provisioned on the TENCENT video vendor (vendor: tx; supports: ${supports}), and this library implements only the Aliyun LinkVisual path \u2014 the channel id it needs lives on Aliyun and a tx device has none. Re-pairing or re-opening the camera in the app will not change this.`;
+	return `${who} is a camera and online, but has no video channel yet (vendor: ${profile.currentVendor ?? "none"}; supports: ${supports}). The device has not bound to the video service \u2014 open its camera once in the Dreame app to create the binding, then retry.`;
+}
 var MONITOR_SIID = 10001;
 var MONITOR_AIID = {
 	/** Stream lifecycle + keep-alive (monitor start/end, keep_alive). */
@@ -47319,6 +47344,33 @@ function firstOutValue(res) {
 	const out = r?.out ?? r?.result?.out;
 	return Array.isArray(out) && out.length > 0 ? out[0]?.value : void 0;
 }
+function videoVendorSwitchParams(vendor) {
+	return { vendor };
+}
+function parseVideoVendorStatus(raw) {
+	const text = typeof raw === "string" ? raw : typeof raw === "object" && raw !== null ? null : null;
+	const source = text === null ? raw : safeJson(text);
+	if (typeof source !== "object" || source === null) return {
+		vendor: null,
+		initStatus: null
+	};
+	const v = Reflect.get(source, "vendor");
+	const s = Reflect.get(source, "initStatus");
+	return {
+		vendor: v === "ali" || v === "tx" ? v : null,
+		initStatus: typeof s === "number" ? s : null
+	};
+}
+function safeJson(text) {
+	try {
+		return JSON.parse(text);
+	} catch {
+		return null;
+	}
+}
+function vendorSwitchSettled(status, wanted) {
+	return status.vendor === wanted && status.initStatus === 1;
+}
 var DEFAULT_KEEP_ALIVE_MS = 1e4;
 var DEFAULT_AREA = "4";
 var DreameCameraController = class {
@@ -50178,12 +50230,16 @@ var VacuumDevice = class _VacuumDevice extends BaseDevice$1 {
 			session,
 			region
 		});
-		const iotId = opts?.iotId ?? (await getDeviceVideoProfile({
-			session,
-			region,
-			did: this.deviceId
-		})).iotId;
-		if (!iotId) throw new DreameError("device has no LinkVisual iotId; not a camera device or not provisioned");
+		let iotId = opts?.iotId ?? null;
+		if (!iotId) {
+			const profile = await getDeviceVideoProfile({
+				session,
+				region,
+				did: this.deviceId
+			});
+			iotId = profile.iotId;
+			if (!iotId) throw new DreameError(explainNoCameraChannel(profile) ?? "device has no video channel");
+		}
 		return new DreameCameraController({
 			device: this,
 			relay,
@@ -50198,6 +50254,54 @@ var VacuumDevice = class _VacuumDevice extends BaseDevice$1 {
 			...opts?.log ? { log: opts.log } : {}
 		});
 	}
+	/**
+	* What video backend this robot is on, and whether that backend's SDK is up.
+	*
+	* A CACHED read by default: the cloud shadow answers for a robot on its dock
+	* without waking it, which is the whole point of asking before deciding how
+	* to stream. Pass `{ live: true }` when the answer must be current — while a
+	* switch settles, for instance.
+	*/
+	async readVideoVendorStatus(opts) {
+		const props = [{
+			siid: MONITOR_SIID,
+			piid: MONITOR_PIID.VIDEO_VENDOR_STATUS
+		}];
+		return parseVideoVendorStatus((opts?.live === true ? await this.refreshProperties(props) : await this.refreshCachedProperties(props))[0]?.value);
+	}
+	/**
+	* Move this robot onto a video backend, and WAIT until it is really there.
+	*
+	* The two backends are not interchangeable: measured on an X50 on
+	* 2026-09-16, a robot on `tx` offers only Tencent's proprietary UDP P2P
+	* plane (`getRtcInfo` answers 404), while the same robot on `ali` streams
+	* through a plain RTMP relay this library implements end to end. So which
+	* one it sits on decides whether it can be streamed at all.
+	*
+	* The device reports the NEW vendor before its SDK is up, which is why the
+	* app polls rather than trusting the action's return — and why this resolves
+	* on `initStatus === 1` and not a moment earlier. A half-switched robot
+	* answers questions about a backend it cannot yet serve.
+	*
+	* Only meaningful on a dual-vendor device (`videoDynamicVendor`, with the
+	* target in `defaultVendors`); a device that cannot move simply never
+	* settles, and this reports that as a timeout rather than a silent success.
+	*/
+	async setVideoVendor(vendor, opts) {
+		const already = await this.readVideoVendorStatus({ live: true });
+		if (vendorSwitchSettled(already, vendor)) return already;
+		const session = makeMonitorSession(this.currentSession().uid);
+		await this.callAction(MONITOR_SIID, MONITOR_AIID.VIDEO_VENDOR, [buildActionInput(MONITOR_PIID.VIDEO_VENDOR_STATUS, videoVendorSwitchParams(vendor), session)]);
+		const every = opts?.pollIntervalMs ?? 5e3;
+		const deadline = Date.now() + (opts?.timeoutMs ?? every * 10);
+		let last = already;
+		while (Date.now() < deadline) {
+			await new Promise((r) => setTimeout(r, every));
+			last = await this.readVideoVendorStatus({ live: true });
+			if (vendorSwitchSettled(last, vendor)) return last;
+		}
+		throw new DreameError(`video vendor did not settle on "${vendor}" within the timeout (last seen: vendor=${last.vendor ?? "unknown"}, initStatus=${String(last.initStatus)})`);
+	}
 	/** Props worth seeding on start() / polling — exported for the facade. */
 	static DEFAULT_PROPS = [
 		VACUUM_PROP.STATE,
@@ -66166,6 +66270,107 @@ var ExposeInputSchema = object({
 });
 var UnexposeInputSchema = object({ deviceId: string() });
 method(_void(), DeviceExportStatusSchema), method(_void(), array(DeviceKindSchema)), method(_void(), array(ExposedDeviceSchema)), method(ExposeInputSchema, _void(), { kind: "mutation" }), method(UnexposeInputSchema, _void(), { kind: "mutation" });
+/** Wire/storage schema for one icon id. */
+var LocationIconIdSchema = _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 = object({
+	locationKey: string(),
+	icon: LocationIconIdSchema
+});
+/**
+* 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 = object({
+	locationKey: string(),
+	description: 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 = object({
+	zoneKey: string(),
+	label: 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: array(string())
+});
 var ProviderStatusSchema = object({
 	connected: boolean(),
 	deviceCount: number(),
@@ -66758,6 +66963,39 @@ method(object({
 }), object({ moved: number() }), {
 	kind: "mutation",
 	auth: "admin"
+}), method(_void(), array(LocationIconAssignmentSchema)), method(object({
+	location: string(),
+	icon: LocationIconIdSchema.nullable()
+}), _void(), {
+	kind: "mutation",
+	auth: "admin"
+}), method(_void(), array(LocationDescriptionAssignmentSchema)), method(object({
+	location: string(),
+	description: string().max(400).nullable()
+}), _void(), {
+	kind: "mutation",
+	auth: "admin"
+}), method(_void(), array(SiteZoneSchema)), method(object({
+	name: string(),
+	icon: LocationIconIdSchema.nullable().optional()
+}), _void(), {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({ name: string() }), _void(), {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({
+	from: string(),
+	to: string()
+}), _void(), {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({
+	location: string(),
+	zone: string().nullable()
+}), _void(), {
+	kind: "mutation",
+	auth: "admin"
 }), method(object({
 	deviceId: number(),
 	disabled: boolean()
@@ -89841,6 +90079,18 @@ 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",
@@ -89853,6 +90103,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"deviceManager.listSiteZones": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.listWrappersForCap": {
 		capName: "device-manager",
 		capScope: "system",
@@ -89937,12 +90193,24 @@ 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",
@@ -89985,6 +90253,24 @@ 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",
@@ -90015,6 +90301,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.setSiteZone": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"deviceManager.setStreamProfileMap": {
 		capName: "device-manager",
 		capScope: "system",
@@ -98760,6 +99052,15 @@ var dreameChildSchema = object({
 	/** Privacy PIN set at pairing — required to wake a coded camera (camera child only). */
 	navigationAccessCode: string().optional(),
 	/**
+	* The video backend the robot should sit on (camera child only).
+	*
+	* Not a preference the addon enforces: it is written THROUGH to the device
+	* by `applySettingsPatch`, and the device is the authority on where it
+	* actually is. Stored so the settings form has a value to show before the
+	* first read answers.
+	*/
+	videoVendor: _enum(["ali", "tx"]).optional(),
+	/**
 	* ms-epoch of the ONE-SHOT recording seed (camera child only, D380).
 	*
 	* A MARK, never the value: it says this camera was seeded, which stays true
@@ -145670,6 +145971,58 @@ function navigationSlice(prev, patch, now) {
 * for two separate things (admin UI: two tabs; viewer: one panel that shows the
 * navigation controls when the device has the cap).
 */
+/**
+* The camera child's settings form.
+*
+* A PURE export so the shape can be asserted without constructing a device —
+* the same discipline `navigationSlice` follows in this file. What matters
+* here is that the backend selector offers exactly the two vendors this
+* library can stream, in the order that puts the working one first.
+*/
+var CAMERA_SETTINGS_SCHEMA = { sections: [{
+	id: "camera-backend",
+	title: "Video backend",
+	description: "Which cloud video service this robot streams through. The two are not interchangeable: only the Aliyun path is implemented here — a robot on Tencent can be seen in the Dreame app but not by CamStack, because Tencent offers it a proprietary P2P plane we do not speak. Changing this asks the ROBOT to switch and waits until its SDK reports ready; the robot is the authority on where it actually is.",
+	fields: [{
+		type: "select",
+		key: "videoVendor",
+		label: "Backend",
+		description: "Aliyun streams through a plain relay and works today. Tencent is offered so the other path can be tested once it exists.",
+		options: [{
+			value: "ali",
+			label: "Aliyun LinkVisual (supported)"
+		}, {
+			value: "tx",
+			label: "Tencent IoT-Video (not implemented yet)"
+		}]
+	}]
+}, {
+	id: "camera-access",
+	title: "Camera access",
+	description: "The privacy code set when the robot camera was paired. The robot refuses to open its camera without it.",
+	fields: [{
+		type: "password",
+		key: "navigationAccessCode",
+		label: "Camera access code",
+		showToggle: true
+	}]
+}] };
+/**
+* The values the form opens with.
+*
+* The DEVICE wins: it is the authority on which backend it is on, and the
+* stored preference is only what the operator last asked for. Showing the
+* preference while the robot sits elsewhere would tell the operator the switch
+* had worked when it had not. Before the first read has answered there is
+* nothing to show but the preference, and an empty string when there is
+* neither — unknown, never a default that looks like a fact (D393).
+*/
+function cameraSettingsValues(input) {
+	return {
+		navigationAccessCode: input.accessCode ?? "",
+		videoVendor: input.vendorNow ?? input.storedVendor ?? ""
+	};
+}
 var DreameCameraDevice = class extends DreameChildDevice {
 	features = [DeviceFeature.BatteryOperated];
 	constructor(ctx) {
@@ -145745,6 +146098,31 @@ var DreameCameraDevice = class extends DreameChildDevice {
 		});
 	}
 	/** One reader of the robot's link, shared in shape with the vacuum's. */
+	/**
+	* Where the robot says its video backend is, as last read.
+	*
+	* The settings schema is built synchronously and this is a device read, so
+	* it is cached and refreshed in the background when the form is opened — the
+	* serve-and-revalidate discipline D224 describes.
+	*
+	* `null` means never read, which the form shows as the stored preference
+	* instead — unknown is not the same fact as "on ali" (D393).
+	*/
+	vendorNow = null;
+	/** Refresh {@link vendorNow}. Never throws: the settings page must open
+	*  whether or not the robot answered. */
+	async refreshVendorNow() {
+		const handle = this.resolveHandle();
+		if (!(handle instanceof VacuumDevice)) return;
+		try {
+			this.vendorNow = (await handle.readVideoVendorStatus({ live: true })).vendor;
+		} catch (err) {
+			this.ctx.logger.debug("robot camera: video backend read failed", {
+				tags: { deviceId: this.id },
+				meta: { error: errMsg(err) }
+			});
+		}
+	}
 	networkLink = new DreameNetworkLinkMonitor({
 		deviceId: this.id,
 		logger: this.ctx.logger,
@@ -146071,20 +146449,58 @@ var DreameCameraDevice = class extends DreameChildDevice {
 	* offers is a setting that does not exist.
 	*/
 	getSettingsUISchema() {
-		return hydrateSchema({ sections: [{
-			id: "camera-access",
-			title: "Camera access",
-			description: "The privacy code set when the robot camera was paired. The robot refuses to open its camera without it.",
-			fields: [{
-				type: "password",
-				key: "navigationAccessCode",
-				label: "Camera access code",
-				showToggle: true
-			}]
-		}] }, { navigationAccessCode: this.config.get("navigationAccessCode") ?? "" });
+		this.refreshVendorNow();
+		return hydrateSchema(CAMERA_SETTINGS_SCHEMA, cameraSettingsValues({
+			accessCode: this.config.get("navigationAccessCode"),
+			vendorNow: this.vendorNow,
+			storedVendor: this.config.get("videoVendor")
+		}));
 	}
 	async applySettingsPatch(patch) {
+		this.ctx.logger.info("robot camera: settings patch received", {
+			tags: { deviceId: this.id },
+			meta: {
+				keys: Object.keys(patch).sort(),
+				vendorNow: this.vendorNow
+			}
+		});
 		await super.applySettingsPatch(patch);
+		const wanted = patch["videoVendor"];
+		if ((wanted === "ali" || wanted === "tx") && wanted !== this.vendorNow) {
+			const handle = this.resolveHandle();
+			if (handle instanceof VacuumDevice) {
+				await this.closeStream("removed");
+				this.controller = null;
+				this.controllerHandle = null;
+				this.ctx.logger.info("robot camera: switching video backend", {
+					tags: { deviceId: this.id },
+					meta: {
+						from: this.vendorNow,
+						to: wanted
+					}
+				});
+				try {
+					const settled = await handle.setVideoVendor(wanted);
+					this.vendorNow = settled.vendor;
+					this.ctx.logger.info("robot camera: video backend switched", {
+						tags: { deviceId: this.id },
+						meta: {
+							vendor: settled.vendor,
+							initStatus: settled.initStatus
+						}
+					});
+				} catch (err) {
+					this.ctx.logger.warn("robot camera: video backend switch refused", {
+						tags: { deviceId: this.id },
+						meta: {
+							to: wanted,
+							error: errMsg(err)
+						}
+					});
+					throw err;
+				}
+			}
+		}
 		if (!("navigationAccessCode" in patch)) return;
 		await this.closeStream("removed");
 		this.controller = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-dreame",
-  "version": "0.2.106",
+  "version": "0.2.108",
   "description": "Dreame robot-vacuum / lawn-mower device-provider addon for CamStack — wraps the @apocaliss92/nodedreame Dreamehome cloud client",
   "keywords": [
     "camstack",
@@ -80,7 +80,7 @@
     "publish:npm": "npm publish --access public"
   },
   "devDependencies": {
-    "@apocaliss92/nodedreame": "^1.12.0",
+    "@apocaliss92/nodedreame": "^1.12.4",
     "@apocaliss92/nodelink-js": "^0.6.7",
     "@camstack/types": "*",
     "typescript": "~6.0.3",