@camstack/addon-provider-dreame 0.2.147 → 0.2.149

package/dist/addon.js

@@ -44,7 +44,7 @@ let net = require("net");
 net = __toESM(net, 1);
 let zlib = require("zlib");
 zlib = __toESM(zlib, 1);
-//#region ../types/dist/event-category-DOl51-Ij.mjs
+//#region ../types/dist/event-category-BfJwUd2S.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -361,6 +361,15 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	*/
 	EventCategory["PipelineDetectionBlind"] = "pipeline.detection-blind";
 	/**
+	* A camera's motion source has fired constantly with no subject for an hour
+	* (motion duty or session count over the bar, zero detections) — it is not
+	* blind, its motion zones or sensitivity want tuning (D907). Paired with
+	* {@link PipelineMotionCalm}.
+	*/
+	EventCategory["PipelineMotionNoisy"] = "pipeline.motion-noisy";
+	/** The recovery edge of {@link PipelineMotionNoisy}: the motion fell back, or a detection arrived. */
+	EventCategory["PipelineMotionCalm"] = "pipeline.motion-calm";
+	/**
 	* Per-camera pipeline config was mutated by the orchestrator
 	* (3-level settings change via `setAgentAddonDefaults` /
 	* `setCameraStepToggle` / `setCameraPipelineForAgent` or a
@@ -732,6 +741,14 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["BackupRestored"] = "backup.restored";
 	EventCategory["NotificationDispatched"] = "notification.dispatched";
 	EventCategory["NotificationFailed"] = "notification.failed";
+	/**
+	* A notification rule that cannot work (D905): its stored row does not load,
+	* or it still names a device / delivery target the prune CONFIRMED deleted.
+	* One edge per rule per distinct set of reasons; never on an unanswered read.
+	*/
+	EventCategory["NotificationRuleBroken"] = "notification.rule-broken";
+	/** The clear of {@link NotificationRuleBroken}: the rule loads and names nothing deleted. */
+	EventCategory["NotificationRuleRepaired"] = "notification.rule-repaired";
 	EventCategory["DeviceUpdated"] = "device.updated";
 	/**
 	* Transport-level connectivity. Emitted by the device driver when
@@ -5459,7 +5476,7 @@ var ZodIssueCode$1 = {
 var ZodFirstPartyTypeKind$1;
 ZodFirstPartyTypeKind$1 || (ZodFirstPartyTypeKind$1 = {});
 //#endregion
-//#region ../types/dist/sleep-_sV1BE2f.mjs
+//#region ../types/dist/sleep-DJFUfKvA.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -7988,7 +8005,7 @@ var EntryDescriptorSchema = object({
 	/** JSON Schema of the entry body; `secret: true` marks a password field. */
 	fields: record(string(), unknown())
 }).strict();
-/** What crosses the wire and sits in the engine's catalog: JSON only, no Zod. */
+/** What crosses the wire from an addon: JSON only, no Zod. An unknown key is refused. */
 var RecordKindDeclarationSchema = object({
 	database: _enum(RECORD_DATABASES).default("settings"),
 	class: _enum(RECORD_CLASSES),
@@ -8007,14 +8024,6 @@ var RecordKindDeclarationSchema = object({
 	secretPaths: array(string().min(1)).default([]),
 	/** The id key of each array that carries a secret (`{ headers: 'name' }`). */
 	secretArrayKeys: record(string(), string()).default({}),
-	/**
-	* RETIRED (D900): the legacy table a kind adopted from during the records
-	* migration. Nothing declares it any more and nothing reads it; the schema
-	* still ACCEPTS it because the catalog rows the migration wrote carry it
-	* (an orphaned kind is never redeclared) and an addon built before the
-	* removal still sends it. Never set it.
-	*/
-	adoptsFrom: string().min(1).optional(),
 	/** Kinds that must agree through `transact` sit in one file under one family name. */
 	transactFamily: string().min(1).optional(),
 	entry: EntryDescriptorSchema.optional()
@@ -12706,17 +12715,6 @@ object({
 	createdAt: number(),
 	updatedAt: number()
 });
-object({
-	id: string(),
-	label: string(),
-	isAdmin: boolean().default(false),
-	allowedProviders: AllowedProviderSchema,
-	allowedDevices: AllowedDevicesSchema,
-	tokenHash: string(),
-	tokenPrefix: string(),
-	createdAt: number(),
-	lastUsedAt: number().optional()
-});
 object({
 	id: string(),
 	userId: string(),
@@ -16698,16 +16696,36 @@ var RecordKindStateSchema = _enum([
 var DeclareKindResultSchema = object({
 	kindId: number().int(),
 	state: RecordKindStateSchema,
-	createdIndexes: array(string()),
-	/**
-	* RETIRED (D900): always `null`. It carried the records-migration boot guard;
-	* it stays on the wire, null, because an addon built before the removal reads
-	* an ABSENT field as "adoption pending" and refuses to start.
-	*/
-	adoptionPending: _null()
+	createdIndexes: array(string())
 });
 /** Keychain refs a write released (the old marker is gone from the row): the owner deletes the values. */
 var SecretRefsList = array(string());
+/**
+* One op of a `transact`: the single-row writes, each on a kind of the caller.
+* All ops of one call share ONE database file and ONE `transactFamily`.
+*/
+var RecordTransactOpSchema = discriminatedUnion("op", [
+	object({
+		op: literal("put"),
+		kind: RecordKindNameSchema,
+		record: RecordInputSchema,
+		ifRev: number().int().min(0).optional()
+	}),
+	object({
+		op: literal("patch"),
+		kind: RecordKindNameSchema,
+		id: RecordIdSchema,
+		data: RecordBodySchema,
+		at: number().int().nullable().optional(),
+		expiresAt: number().int().nullable().optional(),
+		ifRev: number().int().min(1).optional()
+	}),
+	object({
+		op: literal("delete"),
+		kind: RecordKindNameSchema,
+		id: RecordIdSchema
+	})
+]);
 var RecordSecretRefsSchema = record(string(), record(string(), string()));
 method(object({ kinds: record(RecordKindNameSchema, RecordKindDeclarationSchema) }), object({ kinds: record(string(), DeclareKindResultSchema) }), {
 	kind: "mutation",
@@ -16814,6 +16832,16 @@ method(object({ kinds: record(RecordKindNameSchema, RecordKindDeclarationSchema)
 }), {
 	kind: "mutation",
 	auth: "admin"
+}), method(object({ ops: array(RecordTransactOpSchema).min(1).max(RECORD_BATCH_MAX) }), object({
+	results: array(object({
+		rev: number().int().nullable(),
+		deleted: boolean()
+	})),
+	releasedRefs: SecretRefsList,
+	secretRefs: SecretRefsList
+}), {
+	kind: "mutation",
+	auth: "admin"
 }), method(object({
 	deviceId: number().int(),
 	kinds: array(RecordKindNameSchema).optional()
@@ -42437,9 +42465,13 @@ var NcSystemEventKindSchema = _enum([
 	"node-updating",
 	"node-inference-unavailable",
 	"detection-blind",
+	"motion-noisy",
+	"motion-calm",
 	"recording-stalled",
 	"recording-healthy",
 	"recording-degraded",
+	"device-attention-required",
+	"device-attention-resolved",
 	"storage-location-low",
 	"storage-location-critical",
 	"storage-location-ok",
@@ -42463,6 +42495,8 @@ var NcSystemEventKindSchema = _enum([
 	"alert-critical",
 	"alert-error",
 	"alert-critical-resolved",
+	"rule-broken",
+	"rule-repaired",
 	"camera-online",
 	"camera-offline",
 	"camera-disabled",
@@ -55786,6 +55820,16 @@ var DishwasherStatusSchema = object({
 	powerState: string().nullable(),
 	saltLevel: DishwasherConsumableLevelSchema.nullable(),
 	rinseAidLevel: DishwasherConsumableLevelSchema.nullable(),
+	/**
+	* True while the appliance asks for its filter to be cleaned (smart-filter, filter-system or
+	* combined care-and-filter reminder raised); false when every such reminder reads clear; null
+	* when none is reported. A cleared reminder is not an unknown one.
+	*/
+	filterCleaningDue: boolean().nullable(),
+	/** True while the machine-care (descaling / cleaning-program) reminder is raised; false when clear; null when not reported. */
+	machineCareDue: boolean().nullable(),
+	/** Program runs left before the machine-care reminder is due; null when the appliance does not say. */
+	machineCareRemainingRuns: number().int().nonnegative().nullable(),
 	/** Option states: null when the appliance does not expose the option or has not said. */
 	halfLoad: boolean().nullable(),
 	hygienePlus: boolean().nullable(),
@@ -64584,16 +64628,6 @@ var UpdateUserInputSchema = object({
 	allowedDevices: record(string(), union([array(string()), literal("*")])).optional(),
 	scopes: array(TokenScopeSchema).optional()
 });
-var ApiKeySummarySchema = object({
-	id: string(),
-	label: string(),
-	isAdmin: boolean().default(false),
-	allowedProviders: union([array(string()), literal("*")]).optional(),
-	allowedDevices: record(string(), union([array(string()), literal("*")])).optional(),
-	tokenPrefix: string(),
-	createdAt: number(),
-	lastUsedAt: number().optional()
-});
 var OauthSessionSummarySchema = object({
 	id: string(),
 	userId: string(),
@@ -64615,8 +64649,7 @@ var TotpStatusSchema = object({
 	confirmedAt: number().nullable()
 });
 /**
-* user-management — singleton capability for user accounts and the
-* legacy API-key rows.
+* user-management — singleton capability for user accounts.
 *
 * v2 model: every method gated by `auth: 'admin'`. Admin-only delegation
 * — the subset check on `setUserScopes` is moot
@@ -64672,10 +64705,6 @@ method(_void(), array(UserSummarySchema), { auth: "admin" }), method(CreateUserI
 }), UserSummarySchema.extend({ passwordHash: string() }).nullable(), {
 	kind: "mutation",
 	access: "view"
-}), method(_void(), array(ApiKeySummarySchema), { auth: "admin" }), method(object({ id: string() }), object({ success: literal(true) }), {
-	kind: "mutation",
-	auth: "admin",
-	access: "delete"
 }), method(object({ userId: string() }), TotpSetupResultSchema, {
 	kind: "mutation",
 	auth: "admin",
@@ -74147,6 +74176,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"records.transact": {
+		capName: "records",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"sceneMonitor.captureReference": {
 		capName: "scene-monitor",
 		capScope: "device",
@@ -75479,12 +75514,6 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
-	"userManagement.listApiKeys": {
-		capName: "user-management",
-		capScope: "system",
-		addonId: null,
-		access: "view"
-	},
 	"userManagement.listExternalIdentities": {
 		capName: "user-management",
 		capScope: "system",
@@ -75539,12 +75568,6 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
-	"userManagement.revokeApiKey": {
-		capName: "user-management",
-		capScope: "system",
-		addonId: null,
-		access: "delete"
-	},
 	"userManagement.revokeOauthSession": {
 		capName: "user-management",
 		capScope: "system",
@@ -78909,9 +78932,13 @@ new Map(Object.entries({
 	"stream-online": "device-events",
 	"stream-offline": "device-events",
 	"detection-blind": "device-events",
+	"motion-noisy": "device-events",
+	"motion-calm": "device-events",
 	"recording-stalled": "device-events",
 	"recording-healthy": "device-events",
 	"recording-degraded": "device-events",
+	"device-attention-required": "device-events",
+	"device-attention-resolved": "device-events",
 	"node-online": "system",
 	"node-offline": "system",
 	"node-restarting": "system",
@@ -78928,6 +78955,8 @@ new Map(Object.entries({
 	"alert-critical": "system",
 	"alert-error": "system",
 	"alert-critical-resolved": "system",
+	"rule-broken": "system",
+	"rule-repaired": "system",
 	"storage-location-low": "system",
 	"storage-location-critical": "system",
 	"storage-location-ok": "system",
@@ -78992,6 +79021,12 @@ var NC_SYSTEM_EVENT_KIND_GROUP_SPECS = [
 		label: "Detecting nothing",
 		kinds: ["detection-blind"]
 	},
+	{
+		id: "motion-noise",
+		family: "device-events",
+		label: "Motion without a subject",
+		kinds: ["motion-noisy", "motion-calm"]
+	},
 	{
 		id: "recording",
 		family: "device-events",
@@ -79002,6 +79037,12 @@ var NC_SYSTEM_EVENT_KIND_GROUP_SPECS = [
 			"recording-degraded"
 		]
 	},
+	{
+		id: "device-attention",
+		family: "device-events",
+		label: "Needs attention",
+		kinds: ["device-attention-required", "device-attention-resolved"]
+	},
 	{
 		id: "nodes",
 		family: "system",
@@ -79062,6 +79103,12 @@ var NC_SYSTEM_EVENT_KIND_GROUP_SPECS = [
 			"alert-critical-resolved"
 		]
 	},
+	{
+		id: "rule-health",
+		family: "system",
+		label: "Notification rules",
+		kinds: ["rule-broken", "rule-repaired"]
+	},
 	{
 		id: "alarm",
 		family: "alarm",
@@ -79135,6 +79182,7 @@ var ALERT_EPISODE = [
 	"alert-error",
 	"alert-critical-resolved"
 ];
+var DEVICE_ATTENTION = ["device-attention-required", "device-attention-resolved"];
 var UPDATES = [
 	"addon-update-available",
 	"server-update-available",
@@ -79164,9 +79212,12 @@ var DEVICE_EVENTS = [
 	"stream-online",
 	"stream-offline",
 	"detection-blind",
+	"motion-noisy",
+	"motion-calm",
 	"recording-stalled",
 	"recording-healthy",
 	"recording-degraded",
+	...DEVICE_ATTENTION,
 	...ALARM
 ];
 /** Every kind a summary may speak about — the two summarisable families. */
@@ -79334,7 +79385,13 @@ var STATE_SUMMARY_VARS = [
 	[...RULE_TEXT],
 	[...RULE_TEXT],
 	[...RULE_TEXT],
-	([...RULE_TEXT], [...ALERT_EPISODE]),
+	[...RULE_TEXT],
+	[...RULE_TEXT],
+	([...RULE_TEXT], [...DEVICE_ATTENTION, ...ALERT_EPISODE]),
+	[...RULE_TEXT],
+	[...RULE_TEXT],
+	[...RULE_TEXT],
+	[...RULE_TEXT],
 	[...RULE_TEXT],
 	[...RULE_TEXT],
 	[...RULE_TEXT],
@@ -79352,11 +79409,11 @@ var STATE_SUMMARY_VARS = [
 	[...RULE_TEXT],
 	[...RULE_TEXT],
 	[...RULE_TEXT],
+	([...RULE_TEXT], [...DEVICE_ATTENTION, ...ALERT_EPISODE]),
 	([...RULE_TEXT], [...ALERT_EPISODE]),
+	([...RULE_TEXT], [...DEVICE_ATTENTION, ...ALERT_EPISODE]),
 	([...RULE_TEXT], [...ALERT_EPISODE]),
-	([...RULE_TEXT], [...ALERT_EPISODE]),
-	([...RULE_TEXT], [...ALERT_EPISODE]),
-	([...RULE_TEXT], [...ALERT_EPISODE]),
+	([...RULE_TEXT], [...DEVICE_ATTENTION, ...ALERT_EPISODE]),
 	[...RULE_TEXT],
 	[...RULE_TEXT],
 	[...RULE_TEXT],
@@ -79377,6 +79434,125 @@ var STATE_SUMMARY_VARS = [
 	[...RULE_TEXT],
 	...STATE_SUMMARY_VARS
 ];
+new Map([
+	{
+		id: "device-connectivity",
+		family: "device-events",
+		label: "Device connectivity (offline / back online)",
+		bad: ["device-offline"],
+		recovery: ["device-online"],
+		snapshotLabel: "Devices offline now",
+		snapshotSection: "device-state"
+	},
+	{
+		id: "device-switch",
+		family: "device-events",
+		label: "Device switched off / back on",
+		bad: ["device-disabled"],
+		recovery: ["device-enabled"],
+		snapshotLabel: "Devices switched off now",
+		snapshotSection: "device-state"
+	},
+	{
+		id: "stream-connectivity",
+		family: "device-events",
+		label: "Stream connectivity (offline / back online)",
+		bad: ["stream-offline"],
+		recovery: ["stream-online"],
+		snapshotLabel: "Streams offline now",
+		snapshotSection: "streams"
+	},
+	{
+		id: "battery",
+		family: "device-events",
+		label: "Battery (low / back to normal)",
+		bad: ["device-battery-low"],
+		recovery: ["device-battery-normal"],
+		snapshotLabel: "Batteries low now",
+		snapshotSection: "battery"
+	},
+	{
+		id: "consumables",
+		family: "device-events",
+		label: "Consumables (low / replaced)",
+		bad: ["device-consumable-low"],
+		recovery: ["device-consumable-normal"],
+		snapshotLabel: "Consumables low now",
+		snapshotSection: "consumables"
+	},
+	{
+		id: "tanks",
+		family: "device-events",
+		label: "Tanks (low or full / back to normal)",
+		bad: ["device-tank-low", "device-tank-full"],
+		recovery: ["device-tank-normal"],
+		snapshotLabel: "Tanks low or full now",
+		snapshotSection: "tanks"
+	},
+	{
+		id: "motion-noise",
+		family: "device-events",
+		label: "Motion without a subject (constant / calm again)",
+		bad: ["motion-noisy"],
+		recovery: ["motion-calm"],
+		snapshotLabel: "Cameras with constant motion now",
+		snapshotSection: null
+	},
+	{
+		id: "recording-health",
+		family: "device-events",
+		label: "Recording health (stalled or degraded / recording again)",
+		bad: ["recording-stalled", "recording-degraded"],
+		recovery: ["recording-healthy"],
+		snapshotLabel: "Recordings stalled now",
+		snapshotSection: null
+	},
+	{
+		id: "device-attention",
+		family: "device-events",
+		label: "Device needs attention (raised / resolved)",
+		bad: ["device-attention-required"],
+		recovery: ["device-attention-resolved"],
+		snapshotLabel: "Devices needing attention now",
+		snapshotSection: null
+	},
+	{
+		id: "node-connectivity",
+		family: "system",
+		label: "Node connectivity (offline / back online)",
+		bad: ["node-offline"],
+		recovery: ["node-online"],
+		snapshotLabel: "Nodes offline now",
+		snapshotSection: "nodes"
+	},
+	{
+		id: "storage-space",
+		family: "system",
+		label: "Storage space (low or critical / ok again)",
+		bad: ["storage-location-low", "storage-location-critical"],
+		recovery: ["storage-location-ok"],
+		snapshotLabel: "Storage locations low now",
+		snapshotSection: null
+	},
+	{
+		id: "critical-alerts",
+		family: "system",
+		label: "Critical alerts (raised / resolved)",
+		bad: ["alert-critical"],
+		recovery: ["alert-critical-resolved"],
+		snapshotLabel: "Critical alerts open now",
+		snapshotSection: null
+	},
+	{
+		id: "rule-health",
+		family: "system",
+		label: "Rule health (broken / repaired)",
+		bad: ["rule-broken"],
+		recovery: ["rule-repaired"],
+		snapshotLabel: "Notification rules broken now",
+		snapshotSection: null
+	}
+].flatMap((spec) => [...spec.bad, ...spec.recovery].map((kind) => [kind, spec])));
 new Set([
 	"disarmed",
 	"armed_home",
@@ -132826,8 +133002,6 @@ function buildConnectionFormSchema() {
 			id: "credentials",
 			title: "Dreamehome account",
 			titleKey: "provider-dreame:connection.s_credentials.title",
-			description: "Sign in with your Dreamehome (Dreame app) account credentials.",
-			descriptionKey: "provider-dreame:connection.s_credentials.description",
 			columns: 1,
 			fields: [{
 				type: "text",
@@ -132849,8 +133023,6 @@ function buildConnectionFormSchema() {
 			id: "region",
 			title: "Region",
 			titleKey: "provider-dreame:connection.s_region.title",
-			description: "Select the Dreame cloud region your account is registered in.",
-			descriptionKey: "provider-dreame:connection.s_region.description",
 			columns: 1,
 			fields: [{
 				type: "select",
@@ -135269,6 +135441,81 @@ function rfcUrl(host, port) {
 	return `tcp://${host}:${String(port)}`;
 }
 //#endregion
+//#region src/devices/dreame-pin-attention.ts
+var REFUSED_CODE_MINUS_ONE = /startMonitor refused \(code -1\)/;
+/** The refusal an error carries, or `null` when it is some other failure. */
+function classifyPinRefusal(err, accessCodeSet) {
+	const message = err instanceof Error ? err.message : String(err);
+	if (!REFUSED_CODE_MINUS_ONE.test(message)) return null;
+	return accessCodeSet ? "rejected" : "missing";
+}
+function pinAlertId(deviceId) {
+	return `dreame.pin-required:${String(deviceId)}`;
+}
+function buildPinAlert(deviceId, deviceName, reason) {
+	const now = Date.now();
+	return {
+		id: pinAlertId(deviceId),
+		category: "device.credentials-required",
+		severity: "critical",
+		title: reason === "missing" ? "Camera PIN required" : "Camera PIN rejected",
+		message: reason === "missing" ? `${deviceName} needs its camera PIN before its video can open. Enter it in the device settings.` : `${deviceName} refused the camera PIN that is set. Enter the correct PIN in the device settings.`,
+		action: {
+			label: "Enter PIN",
+			href: `/devices/${String(deviceId)}`,
+			navigation: "app"
+		},
+		status: "active",
+		read: false,
+		createdAt: now,
+		updatedAt: now,
+		source: {
+			type: "device",
+			id: String(deviceId)
+		},
+		metadata: { episodeKey: reason }
+	};
+}
+/**
+* One device's PIN episode. It raises the alert ONCE per episode, and while the
+* episode is open it tells the wake path to stand down: a refusal that needs the
+* operator is terminal until the PIN setting changes, so the broker's 30 s
+* re-dial must not re-open the monitor and fail again.
+*/
+var PinAttention = class {
+	ports;
+	open = null;
+	constructor(ports) {
+		this.ports = ports;
+	}
+	/** True while the PIN is known to be unusable — the wake must not try. */
+	get blocked() {
+		return this.open !== null;
+	}
+	/** A wake failed. Raises the alert on the first refusal of an episode. */
+	async refused(reason) {
+		if (this.open !== null) return "already-open";
+		this.open = reason;
+		await this.ports.emit(buildPinAlert(this.ports.deviceId, this.ports.deviceName(), reason));
+		return "raised";
+	}
+	/** A monitor opened: the PIN works, the episode is over. */
+	async succeeded() {
+		return this.settingChanged();
+	}
+	/**
+	* The PIN setting changed: the episode is no longer known to be terminal, so
+	* the next wake tries again. The alert is resolved here — a still-wrong PIN
+	* raises a fresh episode on that wake.
+	*/
+	async settingChanged() {
+		if (this.open === null) return false;
+		this.open = null;
+		await this.ports.resolve(pinAlertId(this.ports.deviceId));
+		return true;
+	}
+};
+//#endregion
 //#region src/devices/dreame-navigation-actions.ts
 /** Forward throttle magnitude for a full-forward nudge (device speed units). */
 var FORWARD_SPEED = 200;
@@ -181460,15 +181707,13 @@ var CAMERA_SETTINGS_SCHEMA = { sections: [{
 	id: "camera-backend",
 	title: "Video backend",
 	titleKey: "provider-dreame:camera_settings.s_camera-backend.title",
-	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.",
+	description: "Only the Aliyun path is implemented; a robot on Tencent cannot be viewed by CamStack. Changing this asks the robot to switch.",
 	descriptionKey: "provider-dreame:camera_settings.s_camera-backend.description",
 	fields: [{
 		type: "select",
 		key: "videoVendor",
 		label: "Backend",
 		labelKey: "provider-dreame:camera_settings.s_camera-backend.videoVendor.label",
-		description: "Aliyun streams through a plain relay and works today. Tencent is offered so the other path can be tested once it exists.",
-		descriptionKey: "provider-dreame:camera_settings.s_camera-backend.videoVendor.description",
 		options: [{
 			value: "ali",
 			label: "Aliyun LinkVisual (supported)",
@@ -181654,6 +181899,10 @@ var DreameCameraDevice = class extends DreameChildDevice {
 			const data = event.data;
 			if ((typeof data === "object" && data !== null && "deviceId" in data ? data.deviceId : null) !== this.id) return;
 			if (this.session === null) {
+				if (this.pinAttention.blocked) {
+					this.ctx.logger.debug("robot camera: wake skipped — the camera PIN needs the operator", { tags: { deviceId: this.id } });
+					return;
+				}
 				this.openStream().catch(() => void 0);
 				return;
 			}
@@ -181740,8 +181989,65 @@ var DreameCameraDevice = class extends DreameChildDevice {
 			durationMs: Date.now() - startedAt
 		};
 	}
+	/**
+	* The PIN episode (D911): a monitor refused for want of the camera PIN needs
+	* the operator, so it raises ONE critical alert and the wake stands down
+	* until the PIN setting changes.
+	*/
+	pinAttention = new PinAttention({
+		deviceId: this.id,
+		deviceName: () => this.name,
+		emit: async (alert) => {
+			const emit = this.ctx.api.alerts?.emit;
+			if (emit === void 0) {
+				this.ctx.logger.warn("robot camera: PIN alert skipped — alerts capability missing", { tags: { deviceId: this.id } });
+				return;
+			}
+			try {
+				await emit.mutate(alert);
+				this.ctx.logger.warn("robot camera: PIN alert raised — the wake stops until the PIN changes", {
+					tags: { deviceId: this.id },
+					meta: {
+						alertId: alert.id,
+						episodeKey: alert.metadata?.["episodeKey"]
+					}
+				});
+			} catch (err) {
+				this.ctx.logger.warn("robot camera: PIN alert emit failed", {
+					tags: { deviceId: this.id },
+					meta: { error: errMsg(err) }
+				});
+			}
+		},
+		resolve: async (alertId) => {
+			const update = this.ctx.api.alerts?.update;
+			if (update === void 0) return;
+			try {
+				await update.mutate({
+					alertId,
+					patch: {
+						status: "completed",
+						read: true
+					}
+				});
+				this.ctx.logger.info("robot camera: PIN alert resolved", {
+					tags: { deviceId: this.id },
+					meta: { alertId }
+				});
+			} catch (err) {
+				this.ctx.logger.warn("robot camera: PIN alert resolve failed", {
+					tags: { deviceId: this.id },
+					meta: {
+						alertId,
+						error: errMsg(err)
+					}
+				});
+			}
+		}
+	});
 	openStream() {
 		if (this.opening !== null) return this.opening;
+		if (this.pinAttention.blocked) return Promise.reject(/* @__PURE__ */ new Error("camera PIN unusable — waiting for the operator"));
 		const run = (async () => {
 			const startedAt = Date.now();
 			try {
@@ -181773,6 +182079,7 @@ var DreameCameraDevice = class extends DreameChildDevice {
 				this.publishBattery();
 				this.publishCatalog();
 				await this.publishRelay(this.session);
+				this.pinAttention.succeeded();
 				this.ctx.logger.info("robot camera: monitor open, RTP server published", {
 					tags: { deviceId: this.id },
 					meta: {
@@ -181789,6 +182096,9 @@ var DreameCameraDevice = class extends DreameChildDevice {
 						error: errMsg(err)
 					}
 				});
+				const code = this.config.get("navigationAccessCode");
+				const refusal = classifyPinRefusal(err, code !== void 0 && code !== "");
+				if (refusal !== null) await this.pinAttention.refused(refusal);
 				throw err;
 			}
 		})();
@@ -182006,6 +182316,7 @@ var DreameCameraDevice = class extends DreameChildDevice {
 			}
 		}
 		if (!("navigationAccessCode" in patch)) return;
+		await this.pinAttention.settingChanged();
 		await this.closeStream("removed");
 		this.controller = null;
 		this.controllerHandle = null;
@@ -183825,8 +184136,6 @@ var DreameVacuumMapDevice = class extends DreameChildDevice {
 			id: "map-style",
 			title: "Map Style",
 			titleKey: "provider-dreame:schema.s_map-style.title",
-			description: "Colour scheme and overlays for the rendered cleaning map.",
-			descriptionKey: "provider-dreame:schema.s_map-style.description",
 			columns: 2,
 			fields: [
 				{