@camstack/addon-provider-enpal 0.1.17 → 0.1.18

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.18] - 2026-11-12
+
+### Changed
+
+- Test connection works with only the box address, and the addon icon is the Enpal mark.
+
 ## [0.1.17] - 2026-11-12
 
 ### Changed

package/assets/icon.svg

@@ -1,11 +1,8 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#f5a623" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-  <circle cx="12" cy="12" r="4" />
-  <path d="M12 2v2" />
-  <path d="M12 20v2" />
-  <path d="M2 12h2" />
-  <path d="M20 12h2" />
-  <path d="M4.9 4.9l1.4 1.4" />
-  <path d="M17.7 17.7l1.4 1.4" />
-  <path d="M4.9 19.1l1.4-1.4" />
-  <path d="M17.7 6.3l1.4-1.4" />
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+  <!-- Enpal mark: navy tile and amber E from the public favicon. -->
+  <rect width="24" height="24" fill="#072543"/>
+  <rect x="5" y="5" width="3" height="14" fill="#FFB000"/>
+  <rect x="5" y="5" width="14" height="3" fill="#FFB000"/>
+  <rect x="5" y="10.5" width="9" height="3" fill="#FFB000"/>
+  <rect x="5" y="16" width="14" height="3" fill="#FFB000"/>
 </svg>

package/dist/addon.js

@@ -3,7 +3,7 @@ let node_child_process = require("node:child_process");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
 let node_url = require("node:url");
-//#region ../types/dist/event-category-78tcBemo.mjs
+//#region ../types/dist/event-category-Dv-Gcv1f.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -444,6 +444,15 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	*/
 	EventCategory["DeviceStateChanged"] = "device.state-changed";
 	/**
+	* A device COMMAND (a vocabulary action, D920/D983) settled in the hub's
+	* transition audit (D1022): confirmed, already in place, unconfirmed or
+	* failed. Never a device's own change. Payload: `DeviceCommandSettledEvent`
+	* (`{deviceId, action, outcome, actor, at}`, no arguments). It feeds
+	* the Notification Center `device-command` kind. Telemetry (D8): losing one
+	* costs a notification, never state; the audit row is the record.
+	*/
+	EventCategory["DeviceCommandSettled"] = "device.command-settled";
+	/**
 	* The NATIVE shadow of a cap a composition has claimed fields of moved
 	* (D663). Payload: `{ deviceId, capName, native }` — what the provider
 	* wrote, BEFORE the owned fields are overlaid. Owner-only (D224): it is for
@@ -6048,7 +6057,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-D0roI_CZ.mjs
+//#region ../types/dist/sleep-Czv-4wFH.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -6731,6 +6740,13 @@ async function runAddonMigrations(host, migrations, logger, options = {}) {
 		else skipped.push(id);
 	};
 	const selected = options.only === void 0 ? null : new Set(options.only);
+	const deferred = /* @__PURE__ */ new Set();
+	const deferredBy = (reason) => {
+		if (selected === null || reason === null) return null;
+		const dep = /^dependency-(?:pending|blocked):(.+)$/.exec(reason)?.[1];
+		if (dep === void 0 || !byId.has(dep)) return null;
+		return !selected.has(dep) || deferred.has(dep) ? dep : null;
+	};
 	for (const step of declaration.steps) {
 		if (selected !== null && !selected.has(step.id)) continue;
 		const bound = byId.get(step.id);
@@ -6742,6 +6758,19 @@ async function runAddonMigrations(host, migrations, logger, options = {}) {
 		try {
 			const gate = await host.startMigration({ id: step.id });
 			if (!gate.proceed) {
+				const waitsFor = deferredBy(gate.reason);
+				if (waitsFor !== null) {
+					log.info("migration deferred: its predecessor runs in another phase of this owner", {
+						tags,
+						meta: {
+							waitsFor,
+							reason: gate.reason
+						}
+					});
+					deferred.add(step.id);
+					skipped.push(step.id);
+					continue;
+				}
 				log.warn("migration not run", {
 					tags,
 					meta: {
@@ -10279,6 +10308,13 @@ var DeviceTransitionSchema = object({
 	actor: TransitionActorSchema,
 	command: TransitionCommandSchema.optional()
 });
+object({
+	deviceId: number$1().int(),
+	action: string(),
+	outcome: TransitionOutcomeSchema,
+	actor: TransitionActorSchema,
+	at: number$1()
+});
 var READING_QUANTITIES = [
 	"temperature",
 	"pressure",
@@ -12302,7 +12338,10 @@ var ACTUATOR_CAP_VOCABULARY = {
 	"ir-transmitter": {
 		scope: "device",
 		noun: t("IR / RF transmitter", "Trasmettitore IR / RF"),
-		notOperatorFacing: { send: "a raw pulse train is not something an operator composes in an automation; the remote that owns the command table sends it" }
+		notOperatorFacing: {
+			send: "a raw pulse train is not something an operator composes in an automation; the remote that owns the command table sends it",
+			learn: "an interactive capture the operator starts from the source dialog and answers by pressing a physical remote; no automation can supply the signal"
+		}
 	},
 	control: {
 		scope: "device",
@@ -51167,11 +51206,13 @@ var IrCodecError = class extends Error {
 		this.code = code;
 	}
 };
+/** Maximum number of mark/space entries one pulse train may carry. */
+var IR_TIMINGS_MAX = 1024;
 /**
 * A pulse train in signed microseconds: mark (+) first, then space (-), strictly
 * alternating, no zeros, 2..1024 entries.
 */
-var IrTimingsSchema = array(number$1().int()).min(2).max(1024).superRefine((timings, ctx) => {
+var IrTimingsSchema = array(number$1().int()).min(2).max(IR_TIMINGS_MAX).superRefine((timings, ctx) => {
 	timings.forEach((value, index) => {
 		const expectMark = index % 2 === 0;
 		if (value === 0 || value > 0 !== expectMark) ctx.addIssue({
@@ -51218,15 +51259,186 @@ function decodePronto(code) {
 		carrierHz: Math.round(1e6 / unitUs)
 	};
 }
-/** What a remote command stores: a raw pulse train, or a learned Pronto code. */
-var IrPayloadSchema = discriminatedUnion("kind", [object({
-	kind: literal("raw"),
-	timings: array(number$1().int()),
-	settings: TransmitSettingsSchema.optional()
-}), object({
-	kind: literal("pronto"),
-	code: string()
-})]);
+/**
+* FastLZ level 1: a byte-oriented LZ77 stream. A control byte below 32 starts a
+* literal run of `ctrl + 1` bytes; otherwise it is a back-reference whose length
+* is `ctrl >> 5` (extended by one byte when 7) and whose distance is split
+* between the low 5 bits and the next byte.
+*/
+var MAX_DISTANCE = 8192;
+var MAX_LITERAL_RUN = 32;
+var MIN_MATCH = 3;
+var MAX_MATCH = 264;
+/**
+* Most bytes a decoded IR code may hold: two bytes per timing. A level-1 stream
+* can expand ~130x, so the decoder checks this bound before every write.
+*/
+var IR_DECOMPRESSED_MAX = IR_TIMINGS_MAX * 2;
+function fastlzDecompress(input) {
+	const out = [];
+	let ip = 0;
+	const room = (count) => {
+		if (out.length + count > IR_DECOMPRESSED_MAX) throw new IrCodecError("tuya-malformed", "decompressed code is larger than any IR train");
+	};
+	const next = () => {
+		const byte = input[ip++];
+		if (byte === void 0) throw new IrCodecError("tuya-malformed", "compressed stream is truncated");
+		return byte;
+	};
+	while (ip < input.length) {
+		const ctrl = next();
+		if (ctrl < 32) {
+			room(ctrl + 1);
+			for (let i = 0; i <= ctrl; i++) out.push(next());
+			continue;
+		}
+		let len = (ctrl >> 5) - 1;
+		if (len === 6) len += next();
+		const distance = ((ctrl & 31) << 8) + next() + 1;
+		const start = out.length - distance;
+		if (start < 0) throw new IrCodecError("tuya-malformed", "back-reference points before the stream");
+		room(len + 3);
+		for (let i = 0; i < len + 3; i++) {
+			const byte = out[start + i];
+			if (byte === void 0) throw new IrCodecError("tuya-malformed", "back-reference is invalid");
+			out.push(byte);
+		}
+	}
+	return Uint8Array.from(out);
+}
+function fastlzCompress(input) {
+	const out = [];
+	const lastSeen = /* @__PURE__ */ new Map();
+	let literalStart = 0;
+	const flushLiterals = (end) => {
+		for (let from = literalStart; from < end; from += MAX_LITERAL_RUN) {
+			const to = Math.min(from + MAX_LITERAL_RUN, end);
+			out.push(to - from - 1);
+			for (let i = from; i < to; i++) out.push(input[i] ?? 0);
+		}
+	};
+	let pos = 0;
+	while (pos < input.length) {
+		let matchLen = 0;
+		let matchDistance = 0;
+		if (pos + MIN_MATCH <= input.length) {
+			const key = (input[pos] ?? 0) << 16 | (input[pos + 1] ?? 0) << 8 | (input[pos + 2] ?? 0);
+			const candidate = lastSeen.get(key);
+			lastSeen.set(key, pos);
+			if (candidate !== void 0 && pos - candidate <= MAX_DISTANCE) {
+				let len = 0;
+				while (pos + len < input.length && len < MAX_MATCH && input[candidate + len] === input[pos + len]) len++;
+				if (len >= MIN_MATCH) {
+					matchLen = len;
+					matchDistance = pos - candidate - 1;
+				}
+			}
+		}
+		if (matchLen === 0) {
+			pos++;
+			continue;
+		}
+		flushLiterals(pos);
+		const enc = matchLen - 2;
+		if (enc < 7) out.push(enc << 5 | matchDistance >> 8);
+		else out.push(224 | matchDistance >> 8, enc - 7);
+		out.push(matchDistance & 255);
+		pos += matchLen;
+		literalStart = pos;
+	}
+	flushLiterals(input.length);
+	return Uint8Array.from(out);
+}
+var ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+var MAX_DURATION_US = 65535;
+function toBase64(bytes) {
+	let out = "";
+	for (let i = 0; i < bytes.length; i += 3) {
+		const a = bytes[i] ?? 0;
+		const b = bytes[i + 1] ?? 0;
+		const c = bytes[i + 2] ?? 0;
+		const word = a << 16 | b << 8 | c;
+		out += ALPHABET[word >> 18 & 63];
+		out += ALPHABET[word >> 12 & 63];
+		out += i + 1 < bytes.length ? ALPHABET[word >> 6 & 63] : "=";
+		out += i + 2 < bytes.length ? ALPHABET[word & 63] : "=";
+	}
+	return out;
+}
+function fromBase64(text) {
+	const clean = text.trim().replace(/=+$/, "");
+	if (clean.length === 0 || clean.length % 4 === 1) throw new IrCodecError("tuya-malformed", "not a base64 string");
+	const out = [];
+	let bits = 0;
+	let acc = 0;
+	for (const ch of clean) {
+		const value = ALPHABET.indexOf(ch);
+		if (value < 0) throw new IrCodecError("tuya-malformed", "not a base64 string");
+		acc = acc << 6 | value;
+		bits += 6;
+		if (bits >= 8) {
+			bits -= 8;
+			out.push(acc >> bits & 255);
+		}
+	}
+	return Uint8Array.from(out);
+}
+/** Signed pulse train to a Tuya IR code: base64(FastLZ(uint16 LE durations)). */
+function encodeTuya(timings) {
+	const bytes = new Uint8Array(timings.length * 2);
+	timings.forEach((value, index) => {
+		const duration = Math.abs(value);
+		if (duration === 0 || duration > MAX_DURATION_US) throw new IrCodecError("invalid-timings", `timing ${index} does not fit 16 bits`);
+		bytes[index * 2] = duration & 255;
+		bytes[index * 2 + 1] = duration >> 8;
+	});
+	return toBase64(fastlzCompress(bytes));
+}
+/** A Tuya IR code to a signed pulse train (mark first). Throws `IrCodecError`. */
+function decodeTuya(code) {
+	const bytes = fastlzDecompress(fromBase64(code));
+	if (bytes.length === 0 || bytes.length % 2 !== 0) throw new IrCodecError("tuya-malformed", "payload is not a list of 16-bit durations");
+	const timings = [];
+	for (let i = 0; i < bytes.length; i += 2) {
+		const duration = (bytes[i] ?? 0) | (bytes[i + 1] ?? 0) << 8;
+		timings.push(i / 2 % 2 === 0 ? duration : -duration);
+	}
+	const checked = IrTimingsSchema.safeParse(timings);
+	if (!checked.success) throw new IrCodecError("tuya-malformed", checked.error.message);
+	return checked.data;
+}
+/** Device-native IR code formats a transmitter can replay verbatim. */
+var IrNativeFormatSchema = _enum(["tuya"]);
+/**
+* Longest native code accepted: base64 of the worst-case compressed stream
+* (every decoded byte as a literal, plus one control byte per 32), with margin.
+*/
+var IR_NATIVE_CODE_MAX_CHARS = Math.ceil((IR_DECOMPRESSED_MAX + Math.ceil(IR_DECOMPRESSED_MAX / 32)) / 3) * 4 + 256;
+var IrNativeCodeSchema = object({
+	format: IrNativeFormatSchema,
+	code: string().min(1).max(IR_NATIVE_CODE_MAX_CHARS)
+});
+var IR_NATIVE_CODECS = { tuya: {
+	encode: encodeTuya,
+	decode: decodeTuya
+} };
+/** What a remote command stores: a raw pulse train, a learned Pronto code, or a device-native code. */
+var IrPayloadSchema = discriminatedUnion("kind", [
+	object({
+		kind: literal("raw"),
+		timings: array(number$1().int()),
+		settings: TransmitSettingsSchema.optional()
+	}),
+	object({
+		kind: literal("pronto"),
+		code: string()
+	}),
+	object({
+		kind: literal("native"),
+		format: IrNativeFormatSchema,
+		code: string()
+	})
+]);
 /** Resolve a payload to what `ir-transmitter.send` takes. Throws `IrCodecError`. */
 function toTimings(payload) {
 	if (payload.kind === "pronto") {
@@ -51236,6 +51448,10 @@ function toTimings(payload) {
 			settings: { carrierHz: decoded.carrierHz }
 		};
 	}
+	if (payload.kind === "native") return {
+		timings: IR_NATIVE_CODECS[payload.format].decode(payload.code),
+		settings: {}
+	};
 	const checked = IrTimingsSchema.safeParse(payload.timings);
 	if (!checked.success) throw new IrCodecError("invalid-timings", checked.error.message);
 	return {
@@ -58995,6 +59211,15 @@ var HeroRowModelSchema = object({
 	extras: array(HeroControlSchema).max(2).optional(),
 	trailing: HeroFactSchema.nullable()
 });
+new Set([
+	"temperature",
+	"humidity",
+	"pressure",
+	"illuminance",
+	"reading",
+	"air-quality",
+	"valve"
+]);
 DeviceType.Climate;
 DeviceType.Climate, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer;
 /**
@@ -60083,13 +60308,32 @@ var IrSendResultSchema = object({
 var IrTransmitterInfoSchema = object({
 	media: array(IrMediumSchema),
 	settable: array(TransmitSettingKeySchema),
-	maxTimings: number$1().int().positive()
+	maxTimings: number$1().int().positive(),
+	/** The transmitter can learn a code (`learn`). */
+	learn: boolean().default(false),
+	/** Native code formats the transmitter replays verbatim (`send.native`). */
+	formats: array(IrNativeFormatSchema).default([])
+});
+var IR_LEARN_TIMEOUT_DEFAULT_MS = 2e4;
+var IR_LEARN_TIMEOUT_MAX_MS = 6e4;
+var IrLearnResultSchema = object({
+	/** The code in the device's own format, when it reports one. */
+	native: IrNativeCodeSchema.nullable(),
+	timings: IrTimingsSchema,
+	carrierHz: number$1().int().positive().nullable()
 });
 DeviceType.Generic, method(object({
 	deviceId: number$1().int().nonnegative(),
-	timings: IrTimingsSchema,
+	timings: IrTimingsSchema.optional(),
+	native: IrNativeCodeSchema.optional(),
 	settings: TransmitSettingsSchema.optional()
-}), IrSendResultSchema, {
+}).refine((input) => input.timings === void 0 !== (input.native === void 0), { message: "send takes exactly one of timings or native" }), IrSendResultSchema, {
+	kind: "mutation",
+	auth: "protected"
+}), method(object({
+	deviceId: number$1().int().nonnegative(),
+	timeoutMs: number$1().int().positive().max(IR_LEARN_TIMEOUT_MAX_MS).default(IR_LEARN_TIMEOUT_DEFAULT_MS)
+}), IrLearnResultSchema, {
 	kind: "mutation",
 	auth: "protected"
 }), method(object({ deviceId: number$1().int().nonnegative() }), IrTransmitterInfoSchema, {
@@ -69875,6 +70119,7 @@ var NcSystemEventKindSchema = _enum([
 	"recording-degraded",
 	"device-attention-required",
 	"device-attention-resolved",
+	"device-command",
 	"storage-location-low",
 	"storage-location-critical",
 	"storage-location-ok",
@@ -69937,11 +70182,6 @@ var NC_ALARM_SYSTEM_EVENT_KINDS = [
 	"alarm-sensor-bypass",
 	"alarm-disarmed"
 ];
-/**
-* One coherent system-event condition. `kinds` is the required opt-in safety
-* gate; the remaining lists are optional narrowing filters relevant to the
-* selected kinds.
-*/
 var NcSystemEventConditionSchema = object({
 	kinds: array(NcSystemEventKindSchema).min(1),
 	deviceIds: array(number$1().int()).min(1).optional(),
@@ -69973,6 +70213,28 @@ var NcSystemEventConditionSchema = object({
 	nodeIds: array(string().min(1)).min(1).optional(),
 	packageNames: array(string().min(1)).min(1).optional(),
 	/**
+	* `device-command` only: the vocabulary ACTION IDS (D983, `powerSource.forceRestart`)
+	* this rule speaks about - the same dictionary the automation action blocks
+	* pick from. The hub refuses an id the action index does not know.
+	*/
+	commandActions: array(string().min(1)).min(1).optional(),
+	/** `device-command` only: how the command settled. A device's own change is not a command. */
+	commandOutcomes: array(_enum([
+		"confirmed",
+		"already",
+		"unconfirmed",
+		"failed"
+	])).min(1).optional(),
+	/** `device-command` only: who asked (`user`, `addon`, `action`, `scheduler`, `composition`, `node`). */
+	commandActorKinds: array(_enum([
+		"user",
+		"addon",
+		"action",
+		"scheduler",
+		"composition",
+		"node"
+	])).min(1).optional(),
+	/**
 	* At or below this remaining-life %, a consumable is LOW for THIS rule
 	* (D642). Absent = {@link NC_CONSUMABLE_LOW_PERCENT_DEFAULT}; at most
 	* {@link NC_CONSUMABLE_LOW_PERCENT_MAX}, so every episode can recover. Scoped to the
@@ -70953,6 +71215,13 @@ var NcRuleInputSchema = object({
 	*/
 	groupingSec: number$1().int().min(5).max(60).optional(),
 	/**
+	* Hold deliveries of this rule to one target and, when two or more arrive
+	* before the window ends, send them as one summary. Absent = the kind's
+	* default (`groupWithinSecOf`): 5 s for a system-event rule, 0 for every
+	* other kind. `0` sends each delivery as it does today.
+	*/
+	groupWithinSec: number$1().int().min(0).max(300).optional(),
+	/**
 	* ASK ME TO CONFIRM DETECTIONS (#243): a DETECTION notification of this rule
 	* carries "Correct" / "Wrong" buttons (and, where the channel has room, a
 	* "Wrong, it is a <class>" choice). A tap marks the track for retraining, the
@@ -71389,7 +71658,12 @@ var NcHistoryEntrySchema = object({
 	* Assistant export) must render as "no image right now", never as a
 	* broken link.
 	*/
-	artifactIds: array(string().min(1)).optional()
+	artifactIds: array(string().min(1)).optional(),
+	/**
+	* When this row was folded into a group-window summary, the outbox id of
+	* that one notification. Absent on a row that was sent as itself.
+	*/
+	groupedInto: string().min(1).optional()
 });
 /**
 * Query filter for `getHistory` (spec §4.2). Every field is a narrowing
@@ -91954,6 +92228,13 @@ Object.freeze({
 		access: "view",
 		role: "viewer"
 	},
+	"irTransmitter.learn": {
+		capName: "ir-transmitter",
+		capScope: "device",
+		addonId: null,
+		access: "create",
+		role: "viewer"
+	},
 	"irTransmitter.send": {
 		capName: "ir-transmitter",
 		capScope: "device",
@@ -99805,6 +100086,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"irTransmitter.learn": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"irTransmitter.send": [{
 		name: "deviceId",
 		form: "single",
@@ -101744,7 +102030,10 @@ var NC_SYSTEM_EVENT_FILTER_KEYS = [
 	"deviceTypes",
 	"nodeIds",
 	"packageNames",
-	"consumableLowPercent"
+	"consumableLowPercent",
+	"commandActions",
+	"commandOutcomes",
+	"commandActorKinds"
 ];
 new Map(Object.entries({
 	"device-online": "device-events",
@@ -101767,6 +102056,7 @@ new Map(Object.entries({
 	"recording-degraded": "device-events",
 	"device-attention-required": "device-events",
 	"device-attention-resolved": "device-events",
+	"device-command": "device-events",
 	"node-online": "system",
 	"node-offline": "system",
 	"node-restarting": "system",
@@ -101867,6 +102157,12 @@ var NC_SYSTEM_EVENT_KIND_GROUP_SPECS = [
 		label: "Needs attention",
 		kinds: ["device-attention-required", "device-attention-resolved"]
 	},
+	{
+		id: "device-command",
+		family: "device-events",
+		label: "Commands given to devices",
+		kinds: ["device-command"]
+	},
 	{
 		id: "nodes",
 		family: "system",
@@ -102139,6 +102435,7 @@ var DEVICE_EVENTS = [
 	"recording-healthy",
 	"recording-degraded",
 	...DEVICE_ATTENTION,
+	"device-command",
 	...ALARM
 ];
 /** Every kind a summary may speak about — the two summarisable families. */
@@ -102292,6 +102589,9 @@ var STATE_SUMMARY_VARS = [
 	[...RULE_BODY_ONLY],
 	[...RULE_TEXT],
 	([...RULE_TEXT], [...DEVICE_EVENTS]),
+	[...RULE_TEXT],
+	[...RULE_TEXT],
+	([...RULE_TEXT], [...DEVICE_EVENTS]),
 	([...RULE_TEXT], [...COMBINED_ALARM]),
 	([...RULE_TEXT], [...COMBINED_ALARM]),
 	([...RULE_TEXT], [...DEVICE_EVENTS]),
@@ -105374,7 +105674,39 @@ var enpalConnectionsEntryKind = defineEntryKind("connections", {
 });
 /** Every kind this addon declares, keyed by its name. */
 var enpalRecordKinds = { connections: enpalConnectionsEntryKind };
+var REJECTED_KINDS = new Set([
+	"unauthorized",
+	"token-missing",
+	"empty"
+]);
+function connectionForTest(values) {
+	const host = values["host"];
+	if (typeof host !== "string" || host.trim().length === 0) return null;
+	const parsed = enpalConnectionSchema.safeParse({ ...values });
+	return parsed.success ? parsed.data : null;
+}
+function testFailure(error) {
+	if (error instanceof EnpalError) return {
+		success: false,
+		status: REJECTED_KINDS.has(error.kind) ? "rejected" : "inconclusive",
+		error: error.message
+	};
+	return {
+		success: false,
+		status: "inconclusive",
+		error: "The Enpal box did not answer"
+	};
+}
+function liveProbe(blazor) {
+	return (connection) => readEnpalSnapshot({
+		connection,
+		fetch: globalThis.fetch,
+		now: () => Date.now(),
+		blazor: blazor?.()
+	});
+}
 function buildEnpalInstances(records, deps) {
+	const probe = deps.probe ?? liveProbe(deps.blazor);
 	return new RecordIntegrationInstances(records, enpalConnectionsEntryKind, {
 		description: {
 			role: "devices",
@@ -105384,18 +105716,36 @@ function buildEnpalInstances(records, deps) {
 			},
 			instanceMode: "multiple",
 			kind: "server",
-			canTest: false,
+			canTest: true,
 			kinds: [{
 				id: "connection",
 				label: "Enpal",
 				functionCap: "device-provider",
-				role: "devices"
+				role: "devices",
+				canTest: true
 			}]
 		},
 		formSchema: () => buildConnectionFormSchema(),
 		initialBody: (name) => ({ name }),
 		configured: (body) => (body.host ?? "").length > 0,
-		onChanged: () => deps.onChanged()
+		onChanged: () => deps.onChanged(),
+		test: async ({ values }) => {
+			const connection = connectionForTest(values);
+			if (connection === null) return {
+				success: false,
+				status: "rejected",
+				error: "Host is required"
+			};
+			try {
+				await probe(connection);
+				return {
+					success: true,
+					status: "validated"
+				};
+			} catch (error) {
+				return testFailure(error);
+			}
+		}
 	});
 }
 /**
@@ -105688,7 +106038,10 @@ var EnpalProviderAddon = class extends BaseDeviceProvider {
 			...rowsDepsOver(api),
 			kind: enpalConnectionsEntryKind
 		}));
-		this.instances = buildEnpalInstances(records, { onChanged: () => this.reconcileIntegrations() });
+		this.instances = buildEnpalInstances(records, {
+			onChanged: () => this.reconcileIntegrations(),
+			blazor: () => this.blazorReader ?? void 0
+		});
 		this.blazorReader = await this.createBlazorBridge();
 		this.clients = new EnpalClientRegistry(this.ctx.logger, {
 			blazor: () => this.blazorReader ?? void 0,

package/dist/addon.mjs

@@ -2,7 +2,7 @@ import { spawn } from "node:child_process";
 import { existsSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
-//#region ../types/dist/event-category-78tcBemo.mjs
+//#region ../types/dist/event-category-Dv-Gcv1f.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -443,6 +443,15 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	*/
 	EventCategory["DeviceStateChanged"] = "device.state-changed";
 	/**
+	* A device COMMAND (a vocabulary action, D920/D983) settled in the hub's
+	* transition audit (D1022): confirmed, already in place, unconfirmed or
+	* failed. Never a device's own change. Payload: `DeviceCommandSettledEvent`
+	* (`{deviceId, action, outcome, actor, at}`, no arguments). It feeds
+	* the Notification Center `device-command` kind. Telemetry (D8): losing one
+	* costs a notification, never state; the audit row is the record.
+	*/
+	EventCategory["DeviceCommandSettled"] = "device.command-settled";
+	/**
 	* The NATIVE shadow of a cap a composition has claimed fields of moved
 	* (D663). Payload: `{ deviceId, capName, native }` — what the provider
 	* wrote, BEFORE the owned fields are overlaid. Owner-only (D224): it is for
@@ -6047,7 +6056,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-D0roI_CZ.mjs
+//#region ../types/dist/sleep-Czv-4wFH.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -6730,6 +6739,13 @@ async function runAddonMigrations(host, migrations, logger, options = {}) {
 		else skipped.push(id);
 	};
 	const selected = options.only === void 0 ? null : new Set(options.only);
+	const deferred = /* @__PURE__ */ new Set();
+	const deferredBy = (reason) => {
+		if (selected === null || reason === null) return null;
+		const dep = /^dependency-(?:pending|blocked):(.+)$/.exec(reason)?.[1];
+		if (dep === void 0 || !byId.has(dep)) return null;
+		return !selected.has(dep) || deferred.has(dep) ? dep : null;
+	};
 	for (const step of declaration.steps) {
 		if (selected !== null && !selected.has(step.id)) continue;
 		const bound = byId.get(step.id);
@@ -6741,6 +6757,19 @@ async function runAddonMigrations(host, migrations, logger, options = {}) {
 		try {
 			const gate = await host.startMigration({ id: step.id });
 			if (!gate.proceed) {
+				const waitsFor = deferredBy(gate.reason);
+				if (waitsFor !== null) {
+					log.info("migration deferred: its predecessor runs in another phase of this owner", {
+						tags,
+						meta: {
+							waitsFor,
+							reason: gate.reason
+						}
+					});
+					deferred.add(step.id);
+					skipped.push(step.id);
+					continue;
+				}
 				log.warn("migration not run", {
 					tags,
 					meta: {
@@ -10278,6 +10307,13 @@ var DeviceTransitionSchema = object({
 	actor: TransitionActorSchema,
 	command: TransitionCommandSchema.optional()
 });
+object({
+	deviceId: number$1().int(),
+	action: string(),
+	outcome: TransitionOutcomeSchema,
+	actor: TransitionActorSchema,
+	at: number$1()
+});
 var READING_QUANTITIES = [
 	"temperature",
 	"pressure",
@@ -12301,7 +12337,10 @@ var ACTUATOR_CAP_VOCABULARY = {
 	"ir-transmitter": {
 		scope: "device",
 		noun: t("IR / RF transmitter", "Trasmettitore IR / RF"),
-		notOperatorFacing: { send: "a raw pulse train is not something an operator composes in an automation; the remote that owns the command table sends it" }
+		notOperatorFacing: {
+			send: "a raw pulse train is not something an operator composes in an automation; the remote that owns the command table sends it",
+			learn: "an interactive capture the operator starts from the source dialog and answers by pressing a physical remote; no automation can supply the signal"
+		}
 	},
 	control: {
 		scope: "device",
@@ -51166,11 +51205,13 @@ var IrCodecError = class extends Error {
 		this.code = code;
 	}
 };
+/** Maximum number of mark/space entries one pulse train may carry. */
+var IR_TIMINGS_MAX = 1024;
 /**
 * A pulse train in signed microseconds: mark (+) first, then space (-), strictly
 * alternating, no zeros, 2..1024 entries.
 */
-var IrTimingsSchema = array(number$1().int()).min(2).max(1024).superRefine((timings, ctx) => {
+var IrTimingsSchema = array(number$1().int()).min(2).max(IR_TIMINGS_MAX).superRefine((timings, ctx) => {
 	timings.forEach((value, index) => {
 		const expectMark = index % 2 === 0;
 		if (value === 0 || value > 0 !== expectMark) ctx.addIssue({
@@ -51217,15 +51258,186 @@ function decodePronto(code) {
 		carrierHz: Math.round(1e6 / unitUs)
 	};
 }
-/** What a remote command stores: a raw pulse train, or a learned Pronto code. */
-var IrPayloadSchema = discriminatedUnion("kind", [object({
-	kind: literal("raw"),
-	timings: array(number$1().int()),
-	settings: TransmitSettingsSchema.optional()
-}), object({
-	kind: literal("pronto"),
-	code: string()
-})]);
+/**
+* FastLZ level 1: a byte-oriented LZ77 stream. A control byte below 32 starts a
+* literal run of `ctrl + 1` bytes; otherwise it is a back-reference whose length
+* is `ctrl >> 5` (extended by one byte when 7) and whose distance is split
+* between the low 5 bits and the next byte.
+*/
+var MAX_DISTANCE = 8192;
+var MAX_LITERAL_RUN = 32;
+var MIN_MATCH = 3;
+var MAX_MATCH = 264;
+/**
+* Most bytes a decoded IR code may hold: two bytes per timing. A level-1 stream
+* can expand ~130x, so the decoder checks this bound before every write.
+*/
+var IR_DECOMPRESSED_MAX = IR_TIMINGS_MAX * 2;
+function fastlzDecompress(input) {
+	const out = [];
+	let ip = 0;
+	const room = (count) => {
+		if (out.length + count > IR_DECOMPRESSED_MAX) throw new IrCodecError("tuya-malformed", "decompressed code is larger than any IR train");
+	};
+	const next = () => {
+		const byte = input[ip++];
+		if (byte === void 0) throw new IrCodecError("tuya-malformed", "compressed stream is truncated");
+		return byte;
+	};
+	while (ip < input.length) {
+		const ctrl = next();
+		if (ctrl < 32) {
+			room(ctrl + 1);
+			for (let i = 0; i <= ctrl; i++) out.push(next());
+			continue;
+		}
+		let len = (ctrl >> 5) - 1;
+		if (len === 6) len += next();
+		const distance = ((ctrl & 31) << 8) + next() + 1;
+		const start = out.length - distance;
+		if (start < 0) throw new IrCodecError("tuya-malformed", "back-reference points before the stream");
+		room(len + 3);
+		for (let i = 0; i < len + 3; i++) {
+			const byte = out[start + i];
+			if (byte === void 0) throw new IrCodecError("tuya-malformed", "back-reference is invalid");
+			out.push(byte);
+		}
+	}
+	return Uint8Array.from(out);
+}
+function fastlzCompress(input) {
+	const out = [];
+	const lastSeen = /* @__PURE__ */ new Map();
+	let literalStart = 0;
+	const flushLiterals = (end) => {
+		for (let from = literalStart; from < end; from += MAX_LITERAL_RUN) {
+			const to = Math.min(from + MAX_LITERAL_RUN, end);
+			out.push(to - from - 1);
+			for (let i = from; i < to; i++) out.push(input[i] ?? 0);
+		}
+	};
+	let pos = 0;
+	while (pos < input.length) {
+		let matchLen = 0;
+		let matchDistance = 0;
+		if (pos + MIN_MATCH <= input.length) {
+			const key = (input[pos] ?? 0) << 16 | (input[pos + 1] ?? 0) << 8 | (input[pos + 2] ?? 0);
+			const candidate = lastSeen.get(key);
+			lastSeen.set(key, pos);
+			if (candidate !== void 0 && pos - candidate <= MAX_DISTANCE) {
+				let len = 0;
+				while (pos + len < input.length && len < MAX_MATCH && input[candidate + len] === input[pos + len]) len++;
+				if (len >= MIN_MATCH) {
+					matchLen = len;
+					matchDistance = pos - candidate - 1;
+				}
+			}
+		}
+		if (matchLen === 0) {
+			pos++;
+			continue;
+		}
+		flushLiterals(pos);
+		const enc = matchLen - 2;
+		if (enc < 7) out.push(enc << 5 | matchDistance >> 8);
+		else out.push(224 | matchDistance >> 8, enc - 7);
+		out.push(matchDistance & 255);
+		pos += matchLen;
+		literalStart = pos;
+	}
+	flushLiterals(input.length);
+	return Uint8Array.from(out);
+}
+var ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+var MAX_DURATION_US = 65535;
+function toBase64(bytes) {
+	let out = "";
+	for (let i = 0; i < bytes.length; i += 3) {
+		const a = bytes[i] ?? 0;
+		const b = bytes[i + 1] ?? 0;
+		const c = bytes[i + 2] ?? 0;
+		const word = a << 16 | b << 8 | c;
+		out += ALPHABET[word >> 18 & 63];
+		out += ALPHABET[word >> 12 & 63];
+		out += i + 1 < bytes.length ? ALPHABET[word >> 6 & 63] : "=";
+		out += i + 2 < bytes.length ? ALPHABET[word & 63] : "=";
+	}
+	return out;
+}
+function fromBase64(text) {
+	const clean = text.trim().replace(/=+$/, "");
+	if (clean.length === 0 || clean.length % 4 === 1) throw new IrCodecError("tuya-malformed", "not a base64 string");
+	const out = [];
+	let bits = 0;
+	let acc = 0;
+	for (const ch of clean) {
+		const value = ALPHABET.indexOf(ch);
+		if (value < 0) throw new IrCodecError("tuya-malformed", "not a base64 string");
+		acc = acc << 6 | value;
+		bits += 6;
+		if (bits >= 8) {
+			bits -= 8;
+			out.push(acc >> bits & 255);
+		}
+	}
+	return Uint8Array.from(out);
+}
+/** Signed pulse train to a Tuya IR code: base64(FastLZ(uint16 LE durations)). */
+function encodeTuya(timings) {
+	const bytes = new Uint8Array(timings.length * 2);
+	timings.forEach((value, index) => {
+		const duration = Math.abs(value);
+		if (duration === 0 || duration > MAX_DURATION_US) throw new IrCodecError("invalid-timings", `timing ${index} does not fit 16 bits`);
+		bytes[index * 2] = duration & 255;
+		bytes[index * 2 + 1] = duration >> 8;
+	});
+	return toBase64(fastlzCompress(bytes));
+}
+/** A Tuya IR code to a signed pulse train (mark first). Throws `IrCodecError`. */
+function decodeTuya(code) {
+	const bytes = fastlzDecompress(fromBase64(code));
+	if (bytes.length === 0 || bytes.length % 2 !== 0) throw new IrCodecError("tuya-malformed", "payload is not a list of 16-bit durations");
+	const timings = [];
+	for (let i = 0; i < bytes.length; i += 2) {
+		const duration = (bytes[i] ?? 0) | (bytes[i + 1] ?? 0) << 8;
+		timings.push(i / 2 % 2 === 0 ? duration : -duration);
+	}
+	const checked = IrTimingsSchema.safeParse(timings);
+	if (!checked.success) throw new IrCodecError("tuya-malformed", checked.error.message);
+	return checked.data;
+}
+/** Device-native IR code formats a transmitter can replay verbatim. */
+var IrNativeFormatSchema = _enum(["tuya"]);
+/**
+* Longest native code accepted: base64 of the worst-case compressed stream
+* (every decoded byte as a literal, plus one control byte per 32), with margin.
+*/
+var IR_NATIVE_CODE_MAX_CHARS = Math.ceil((IR_DECOMPRESSED_MAX + Math.ceil(IR_DECOMPRESSED_MAX / 32)) / 3) * 4 + 256;
+var IrNativeCodeSchema = object({
+	format: IrNativeFormatSchema,
+	code: string().min(1).max(IR_NATIVE_CODE_MAX_CHARS)
+});
+var IR_NATIVE_CODECS = { tuya: {
+	encode: encodeTuya,
+	decode: decodeTuya
+} };
+/** What a remote command stores: a raw pulse train, a learned Pronto code, or a device-native code. */
+var IrPayloadSchema = discriminatedUnion("kind", [
+	object({
+		kind: literal("raw"),
+		timings: array(number$1().int()),
+		settings: TransmitSettingsSchema.optional()
+	}),
+	object({
+		kind: literal("pronto"),
+		code: string()
+	}),
+	object({
+		kind: literal("native"),
+		format: IrNativeFormatSchema,
+		code: string()
+	})
+]);
 /** Resolve a payload to what `ir-transmitter.send` takes. Throws `IrCodecError`. */
 function toTimings(payload) {
 	if (payload.kind === "pronto") {
@@ -51235,6 +51447,10 @@ function toTimings(payload) {
 			settings: { carrierHz: decoded.carrierHz }
 		};
 	}
+	if (payload.kind === "native") return {
+		timings: IR_NATIVE_CODECS[payload.format].decode(payload.code),
+		settings: {}
+	};
 	const checked = IrTimingsSchema.safeParse(payload.timings);
 	if (!checked.success) throw new IrCodecError("invalid-timings", checked.error.message);
 	return {
@@ -58994,6 +59210,15 @@ var HeroRowModelSchema = object({
 	extras: array(HeroControlSchema).max(2).optional(),
 	trailing: HeroFactSchema.nullable()
 });
+new Set([
+	"temperature",
+	"humidity",
+	"pressure",
+	"illuminance",
+	"reading",
+	"air-quality",
+	"valve"
+]);
 DeviceType.Climate;
 DeviceType.Climate, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer;
 /**
@@ -60082,13 +60307,32 @@ var IrSendResultSchema = object({
 var IrTransmitterInfoSchema = object({
 	media: array(IrMediumSchema),
 	settable: array(TransmitSettingKeySchema),
-	maxTimings: number$1().int().positive()
+	maxTimings: number$1().int().positive(),
+	/** The transmitter can learn a code (`learn`). */
+	learn: boolean().default(false),
+	/** Native code formats the transmitter replays verbatim (`send.native`). */
+	formats: array(IrNativeFormatSchema).default([])
+});
+var IR_LEARN_TIMEOUT_DEFAULT_MS = 2e4;
+var IR_LEARN_TIMEOUT_MAX_MS = 6e4;
+var IrLearnResultSchema = object({
+	/** The code in the device's own format, when it reports one. */
+	native: IrNativeCodeSchema.nullable(),
+	timings: IrTimingsSchema,
+	carrierHz: number$1().int().positive().nullable()
 });
 DeviceType.Generic, method(object({
 	deviceId: number$1().int().nonnegative(),
-	timings: IrTimingsSchema,
+	timings: IrTimingsSchema.optional(),
+	native: IrNativeCodeSchema.optional(),
 	settings: TransmitSettingsSchema.optional()
-}), IrSendResultSchema, {
+}).refine((input) => input.timings === void 0 !== (input.native === void 0), { message: "send takes exactly one of timings or native" }), IrSendResultSchema, {
+	kind: "mutation",
+	auth: "protected"
+}), method(object({
+	deviceId: number$1().int().nonnegative(),
+	timeoutMs: number$1().int().positive().max(IR_LEARN_TIMEOUT_MAX_MS).default(IR_LEARN_TIMEOUT_DEFAULT_MS)
+}), IrLearnResultSchema, {
 	kind: "mutation",
 	auth: "protected"
 }), method(object({ deviceId: number$1().int().nonnegative() }), IrTransmitterInfoSchema, {
@@ -69874,6 +70118,7 @@ var NcSystemEventKindSchema = _enum([
 	"recording-degraded",
 	"device-attention-required",
 	"device-attention-resolved",
+	"device-command",
 	"storage-location-low",
 	"storage-location-critical",
 	"storage-location-ok",
@@ -69936,11 +70181,6 @@ var NC_ALARM_SYSTEM_EVENT_KINDS = [
 	"alarm-sensor-bypass",
 	"alarm-disarmed"
 ];
-/**
-* One coherent system-event condition. `kinds` is the required opt-in safety
-* gate; the remaining lists are optional narrowing filters relevant to the
-* selected kinds.
-*/
 var NcSystemEventConditionSchema = object({
 	kinds: array(NcSystemEventKindSchema).min(1),
 	deviceIds: array(number$1().int()).min(1).optional(),
@@ -69972,6 +70212,28 @@ var NcSystemEventConditionSchema = object({
 	nodeIds: array(string().min(1)).min(1).optional(),
 	packageNames: array(string().min(1)).min(1).optional(),
 	/**
+	* `device-command` only: the vocabulary ACTION IDS (D983, `powerSource.forceRestart`)
+	* this rule speaks about - the same dictionary the automation action blocks
+	* pick from. The hub refuses an id the action index does not know.
+	*/
+	commandActions: array(string().min(1)).min(1).optional(),
+	/** `device-command` only: how the command settled. A device's own change is not a command. */
+	commandOutcomes: array(_enum([
+		"confirmed",
+		"already",
+		"unconfirmed",
+		"failed"
+	])).min(1).optional(),
+	/** `device-command` only: who asked (`user`, `addon`, `action`, `scheduler`, `composition`, `node`). */
+	commandActorKinds: array(_enum([
+		"user",
+		"addon",
+		"action",
+		"scheduler",
+		"composition",
+		"node"
+	])).min(1).optional(),
+	/**
 	* At or below this remaining-life %, a consumable is LOW for THIS rule
 	* (D642). Absent = {@link NC_CONSUMABLE_LOW_PERCENT_DEFAULT}; at most
 	* {@link NC_CONSUMABLE_LOW_PERCENT_MAX}, so every episode can recover. Scoped to the
@@ -70952,6 +71214,13 @@ var NcRuleInputSchema = object({
 	*/
 	groupingSec: number$1().int().min(5).max(60).optional(),
 	/**
+	* Hold deliveries of this rule to one target and, when two or more arrive
+	* before the window ends, send them as one summary. Absent = the kind's
+	* default (`groupWithinSecOf`): 5 s for a system-event rule, 0 for every
+	* other kind. `0` sends each delivery as it does today.
+	*/
+	groupWithinSec: number$1().int().min(0).max(300).optional(),
+	/**
 	* ASK ME TO CONFIRM DETECTIONS (#243): a DETECTION notification of this rule
 	* carries "Correct" / "Wrong" buttons (and, where the channel has room, a
 	* "Wrong, it is a <class>" choice). A tap marks the track for retraining, the
@@ -71388,7 +71657,12 @@ var NcHistoryEntrySchema = object({
 	* Assistant export) must render as "no image right now", never as a
 	* broken link.
 	*/
-	artifactIds: array(string().min(1)).optional()
+	artifactIds: array(string().min(1)).optional(),
+	/**
+	* When this row was folded into a group-window summary, the outbox id of
+	* that one notification. Absent on a row that was sent as itself.
+	*/
+	groupedInto: string().min(1).optional()
 });
 /**
 * Query filter for `getHistory` (spec §4.2). Every field is a narrowing
@@ -91953,6 +92227,13 @@ Object.freeze({
 		access: "view",
 		role: "viewer"
 	},
+	"irTransmitter.learn": {
+		capName: "ir-transmitter",
+		capScope: "device",
+		addonId: null,
+		access: "create",
+		role: "viewer"
+	},
 	"irTransmitter.send": {
 		capName: "ir-transmitter",
 		capScope: "device",
@@ -99804,6 +100085,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"irTransmitter.learn": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"irTransmitter.send": [{
 		name: "deviceId",
 		form: "single",
@@ -101743,7 +102029,10 @@ var NC_SYSTEM_EVENT_FILTER_KEYS = [
 	"deviceTypes",
 	"nodeIds",
 	"packageNames",
-	"consumableLowPercent"
+	"consumableLowPercent",
+	"commandActions",
+	"commandOutcomes",
+	"commandActorKinds"
 ];
 new Map(Object.entries({
 	"device-online": "device-events",
@@ -101766,6 +102055,7 @@ new Map(Object.entries({
 	"recording-degraded": "device-events",
 	"device-attention-required": "device-events",
 	"device-attention-resolved": "device-events",
+	"device-command": "device-events",
 	"node-online": "system",
 	"node-offline": "system",
 	"node-restarting": "system",
@@ -101866,6 +102156,12 @@ var NC_SYSTEM_EVENT_KIND_GROUP_SPECS = [
 		label: "Needs attention",
 		kinds: ["device-attention-required", "device-attention-resolved"]
 	},
+	{
+		id: "device-command",
+		family: "device-events",
+		label: "Commands given to devices",
+		kinds: ["device-command"]
+	},
 	{
 		id: "nodes",
 		family: "system",
@@ -102138,6 +102434,7 @@ var DEVICE_EVENTS = [
 	"recording-healthy",
 	"recording-degraded",
 	...DEVICE_ATTENTION,
+	"device-command",
 	...ALARM
 ];
 /** Every kind a summary may speak about — the two summarisable families. */
@@ -102291,6 +102588,9 @@ var STATE_SUMMARY_VARS = [
 	[...RULE_BODY_ONLY],
 	[...RULE_TEXT],
 	([...RULE_TEXT], [...DEVICE_EVENTS]),
+	[...RULE_TEXT],
+	[...RULE_TEXT],
+	([...RULE_TEXT], [...DEVICE_EVENTS]),
 	([...RULE_TEXT], [...COMBINED_ALARM]),
 	([...RULE_TEXT], [...COMBINED_ALARM]),
 	([...RULE_TEXT], [...DEVICE_EVENTS]),
@@ -105373,7 +105673,39 @@ var enpalConnectionsEntryKind = defineEntryKind("connections", {
 });
 /** Every kind this addon declares, keyed by its name. */
 var enpalRecordKinds = { connections: enpalConnectionsEntryKind };
+var REJECTED_KINDS = new Set([
+	"unauthorized",
+	"token-missing",
+	"empty"
+]);
+function connectionForTest(values) {
+	const host = values["host"];
+	if (typeof host !== "string" || host.trim().length === 0) return null;
+	const parsed = enpalConnectionSchema.safeParse({ ...values });
+	return parsed.success ? parsed.data : null;
+}
+function testFailure(error) {
+	if (error instanceof EnpalError) return {
+		success: false,
+		status: REJECTED_KINDS.has(error.kind) ? "rejected" : "inconclusive",
+		error: error.message
+	};
+	return {
+		success: false,
+		status: "inconclusive",
+		error: "The Enpal box did not answer"
+	};
+}
+function liveProbe(blazor) {
+	return (connection) => readEnpalSnapshot({
+		connection,
+		fetch: globalThis.fetch,
+		now: () => Date.now(),
+		blazor: blazor?.()
+	});
+}
 function buildEnpalInstances(records, deps) {
+	const probe = deps.probe ?? liveProbe(deps.blazor);
 	return new RecordIntegrationInstances(records, enpalConnectionsEntryKind, {
 		description: {
 			role: "devices",
@@ -105383,18 +105715,36 @@ function buildEnpalInstances(records, deps) {
 			},
 			instanceMode: "multiple",
 			kind: "server",
-			canTest: false,
+			canTest: true,
 			kinds: [{
 				id: "connection",
 				label: "Enpal",
 				functionCap: "device-provider",
-				role: "devices"
+				role: "devices",
+				canTest: true
 			}]
 		},
 		formSchema: () => buildConnectionFormSchema(),
 		initialBody: (name) => ({ name }),
 		configured: (body) => (body.host ?? "").length > 0,
-		onChanged: () => deps.onChanged()
+		onChanged: () => deps.onChanged(),
+		test: async ({ values }) => {
+			const connection = connectionForTest(values);
+			if (connection === null) return {
+				success: false,
+				status: "rejected",
+				error: "Host is required"
+			};
+			try {
+				await probe(connection);
+				return {
+					success: true,
+					status: "validated"
+				};
+			} catch (error) {
+				return testFailure(error);
+			}
+		}
 	});
 }
 /**
@@ -105687,7 +106037,10 @@ var EnpalProviderAddon = class extends BaseDeviceProvider {
 			...rowsDepsOver(api),
 			kind: enpalConnectionsEntryKind
 		}));
-		this.instances = buildEnpalInstances(records, { onChanged: () => this.reconcileIntegrations() });
+		this.instances = buildEnpalInstances(records, {
+			onChanged: () => this.reconcileIntegrations(),
+			blazor: () => this.blazorReader ?? void 0
+		});
 		this.blazorReader = await this.createBlazorBridge();
 		this.clients = new EnpalClientRegistry(this.ctx.logger, {
 			blazor: () => this.blazorReader ?? void 0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-enpal",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "description": "Enpal solar-box device-provider addon for CamStack — PV, battery, grid, house and heat-pump readings from the box's own web-page channel, its local InfluxDB or its device page",
   "keywords": [
     "camstack",
@@ -66,7 +66,7 @@
       }
     ],
     "requires": {
-      "server": ">=1.2.846"
+      "server": ">=1.2.849"
     }
   },
   "files": [