@camstack/addon-provider-reolink 1.2.168 → 1.2.170

package/dist/addon.js

@@ -7503,7 +7503,7 @@ var DeviceRole = /* @__PURE__ */ function(DeviceRole) {
 	return DeviceRole;
 }({});
 //#endregion
-//#region ../types/dist/composition-43aqsZQj.mjs
+//#region ../types/dist/composition-Bzr7GwgP.mjs
 /**
 * The ffmpeg build every CamStack node downloads, per platform and arch.
 *
@@ -7557,20 +7557,20 @@ function portable(target) {
 }
 portable("linux64"), portable("linuxarm64"), portable("macarm64"), portable("mac64");
 /**
-* LA tabella "quale booleano di questo tipo di device conta come ALTO", e il
-* valutatore puro del suo FRONTE.
+* THE table "which boolean of this device type counts as HIGH", and the
+* pure evaluator of its EDGE.
 *
-* UNA tabella per tutti quelli che chiedono "questo device è ALTO?": il
-* trigger `RecordingTriggers.sensorDeviceIds` del recorder, i marker dei
-* sensori della post-analysis, il bridge camera-sensors dell'orchestratore e
-* le sorgenti di un campanello composto (`doorbellFeatureSources`, D671).
-* Una seconda copia divergerebbe alla prima cap aggiunta, e il sintomo — "il
-* sensore fa suonare il campanello ma non registra" — è esattamente D62.
+* ONE table for everyone who asks "is this device HIGH?": the
+* recorder's `RecordingTriggers.sensorDeviceIds` trigger, the post-analysis
+* sensor markers, the orchestrator's camera-sensors bridge and
+* the sources of a composite doorbell (`doorbellFeatureSources`, D671).
+* A second copy would diverge at the first cap added, and the symptom — "the
+* sensor rings the doorbell but does not record" — is exactly D62.
 *
-* ⚠ NON è `DEVICE_STATE_READERS` (`catalogs/device-state-vocabulary.ts`), e le
-* due non vanno unificate: quella risponde a "qual è la PAROLA di stato per una
-* regola" (e include `presence`, `cover`, `alarm-panel`), questa a "qual è il
-* booleano il cui FRONTE conta". Vocabolari deliberatamente diversi.
+* ⚠ NOT `DEVICE_STATE_READERS` (`catalogs/device-state-vocabulary.ts`), and the
+* two must not be unified: that one answers "what is the state WORD for a
+* rule" (and includes `presence`, `cover`, `alarm-panel`), this one "which
+* boolean's EDGE counts". Deliberately different vocabularies.
 */
 /**
 * Known binary / switch source caps → the boolean slice field whose
@@ -7591,6 +7591,8 @@ var SOURCE_CAP_ACTIVE_FIELD = {
 	vibration: "detected",
 	tamper: "tampered"
 };
+/** Cap names whose presence in a device's bindings qualify it as a source. */
+var SOURCE_CAPS = Object.keys(SOURCE_CAP_ACTIVE_FIELD);
 /**
 * Error types for the safe expression engine. Two distinct classes so callers
 * can tell a compile-time (grammar) failure from a runtime (evaluation)
@@ -9197,22 +9199,22 @@ var CLASS_MAP_MACRO_TARGETS = [
 	"package"
 ];
 /**
-* Le macro classi di PRIMO LIVELLO: quelle che un object detector emette e che
-* un operatore può selezionare.
+* The FIRST-LEVEL macro classes: those an object detector emits and that
+* an operator can select.
 *
-* Sono le tre offerte dallo step `object-detection`
+* They are the three offered by the `object-detection` step
 * (`addon-pipeline/src/detection-pipeline/registry/step-definitions.ts`,
-* `enabledMacroClasses`). `package` sta in {@link CLASS_MAP_MACRO_TARGETS} e in
-* `MACRO_LABELS` — è una macro vera — ma NON qui: appartiene allo step
-* `package-detection`, la cui abilitazione è guidata dalle zone, e offrire la
-* stessa parola due volte ha già fatto accendere a un operatore il proxy COCO
+* `enabledMacroClasses`). `package` is in {@link CLASS_MAP_MACRO_TARGETS} and in
+* `MACRO_LABELS` — it is a true macro — but NOT here: it belongs to the step
+* `package-detection`, whose enablement is driven by zones, and offering the
+* same word twice has already made an operator turn on the COCO proxy
 * (suitcase/backpack/handbag) lasciando spento il detector dedicato.
 *
-* UNA lista. Prima di oggi le stesse tre erano scritte a mano nell'offerta
-* dello step e una seconda volta come union `FirstLevelMacro`
-* (`types/detection.ts`); una terza copia per il trigger di registrazione
-* (`RecordingTriggers.objectClasses`) avrebbe reso invisibile la divergenza
-* successiva.
+* ONE list. Before today the same three were hand-written in the step's offer
+* and a second time as the union `FirstLevelMacro`
+* (`types/detection.ts`); a third copy for the recording trigger
+* (`RecordingTriggers.objectClasses`) would have made the later divergence
+* invisible.
 */
 var FIRST_LEVEL_MACRO_CLASSES = [
 	"person",
@@ -9277,17 +9279,17 @@ var RecordingStorageModeSchema = _enum([
 	"on-device-decision"
 ]);
 /**
-* Le macro classi che possono aprire una finestra di registrazione — le stesse
-* tre offerte dallo step `object-detection`, da UNA lista
+* The macro classes that can open a recording window — the same
+* three offered by the `object-detection` step, from ONE list
 * ({@link FIRST_LEVEL_MACRO_CLASSES}).
 */
 var RecordingObjectTriggerClassSchema = _enum(FIRST_LEVEL_MACRO_CLASSES);
 /**
-* True quando `values` non ripete un elemento.
+* True when `values` does not repeat an element.
 *
-* Un duplicato non è innocuo: ogni voce di `objectClasses` / `sensorDeviceIds`
-* diventa una SORGENTE in `bandTriggerSources`, e la stessa sorgente due volte
-* conterebbe due volte le sue finestre in `segmentMissedByMs`.
+* A duplicate is not harmless: every entry of `objectClasses` / `sensorDeviceIds`
+* becomes a SOURCE in `bandTriggerSources`, and the same source twice
+* would count its windows twice in `segmentMissedByMs`.
 */
 var noDuplicates = (values) => new Set(values).size === values.length;
 /** Which detectors trigger an `events`-mode band. */
@@ -9295,34 +9297,34 @@ var RecordingTriggersSchema = object({
 	motion: boolean().optional(),
 	audioThresholdDbfs: number().optional(),
 	/**
-	* Le macro classi la cui detection apre una finestra. ASSENTE = la sorgente
-	* non è ascoltata; un array VUOTO è rifiutato, perché "banda events, trigger
-	* object acceso, nessuna classe" è la stessa forma "abilitata e non registra
-	* nulla, per sempre" contro cui è scritto `eventsBandCanEverDemand`.
+	* The macro classes whose detection opens a window. ABSENT = the source
+	* is not listened to; an EMPTY array is rejected, because "events band, object
+	* trigger on, no class" is the same shape "enabled and records
+	* nothing, forever" that `eventsBandCanEverDemand` is written against.
 	*
-	* Il segnale letto è GIÀ FILTRATO: solo detection `source: 'pipeline'`, cioè
-	* quelle che hanno attraversato `enabledMacroClasses`, i
-	* `minConfidence<Macro>` e il full-frame guard. L'AI a bordo camera
-	* (`source: 'onboard'`) non attraversa nessuno di quei gate e NON apre
-	* finestre — vedi `recorder/object-trigger.ts`.
+	* The signal read is ALREADY FILTERED: only `source: 'pipeline'` detections, i.e.
+	* those that went through `enabledMacroClasses`, the
+	* `minConfidence<Macro>` and the full-frame guard. The camera's onboard AI
+	* (`source: 'onboard'`) goes through none of those gates and does NOT open
+	* windows — see `recorder/object-trigger.ts`.
 	*/
 	objectClasses: array(RecordingObjectTriggerClassSchema).min(1).refine(noDuplicates, { message: "objectClasses must not repeat a class" }).optional(),
 	/**
-	* I device LINKED il cui FRONTE ALTO apre una finestra. Assente = la sorgente
-	* non è ascoltata; un array vuoto è rifiutato per la stessa ragione di
+	* The LINKED devices whose RISING EDGE opens a window. Absent = the source
+	* is not listened to; an empty array is rejected for the same reason as
 	* `objectClasses`.
 	*
-	* Sono id di device SORGENTE, non camere: la banda li nomina, quindi il
-	* percorso caldo (`DeviceStateChanged`, a ritmo di bus su tutta la flotta)
-	* non fa RPC. L'OFFERTA da cui l'operatore li sceglie è un'altra domanda, e
-	* si risolve con `deviceManager.getLinkedDevices` + `getBindingsBatch` per
-	* device (D12) — mai un elenco globale di cap.
+	* These are SOURCE device ids, not cameras: the band names them, so the
+	* hot path (`DeviceStateChanged`, at bus rate across the whole fleet)
+	* does no RPC. The OFFER from which the operator picks them is another question, and
+	* is resolved with `deviceManager.getLinkedDevices` + `getBindingsBatch` per
+	* device (D12) — never a global list of caps.
 	*
-	* Cosa vuol dire "alto" dipende dal TIPO di device e non è deciso qui:
-	* `SOURCE_CAP_ACTIVE_FIELD` (`catalogs/sensor-active-state.ts`) è LA tabella,
-	* la stessa del campanello composto (D671). Ed è il FRONTE, non
-	* il livello: un contatto trovato già aperto al riavvio del runner non fa
-	* registrare.
+	* What "high" means depends on the device TYPE and is not decided here:
+	* `SOURCE_CAP_ACTIVE_FIELD` (`catalogs/sensor-active-state.ts`) is THE table,
+	* the same one as the composite doorbell (D671). And it is the EDGE, not
+	* the level: a contact found already open at runner restart does not
+	* record.
 	*/
 	sensorDeviceIds: array(number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional()
 });
@@ -10574,7 +10576,7 @@ function findTimezone(id) {
 * - **VALUE** — at which level, for which scope, until when. That stays ONE
 *   thing: the logging settings document on the `system` cap. Two authorities
 *   over the values is the exact defect
-*   `docs/design/plans/2026-08-26-logging-per-componente.md` was written to
+*   `docs/design/plans/2026-08-26-per-component-logging.md` was written to
 *   remove; re-introducing it from the cure side would be grotesque.
 *
 * Nothing in this file reads a clock, an env var or a store. The registry is
@@ -12642,7 +12644,7 @@ var BrokerStatusEnum = _enum([
 	"unreachable",
 	"error"
 ]);
-var BrokerInfoSchema$1 = object({
+var BrokerInfoSchema = object({
 	/** Stable broker id. Persisted; survives addon restarts. */
 	id: string(),
 	/** Addon id of the provider that OWNS this broker.
@@ -12775,7 +12777,7 @@ var GetStateInputSchema = object({
 	*  HA:   entity_id (returns the cached entity state). */
 	key: string()
 });
-method(ListInputSchema, array(BrokerInfoSchema$1)), method(GetInputSchema, BrokerInfoSchema$1.nullable()), method(_void(), array(BrokerProviderInfoSchema), { auth: "admin" }), method(AddInputSchema, AddResultSchema, {
+method(ListInputSchema, array(BrokerInfoSchema)), method(GetInputSchema, BrokerInfoSchema.nullable()), method(_void(), array(BrokerProviderInfoSchema), { auth: "admin" }), method(AddInputSchema, AddResultSchema, {
 	kind: "mutation",
 	auth: "admin"
 }), method(RemoveInputSchema, _void(), {
@@ -14486,7 +14488,7 @@ method(_void(), EngineInfoSchema, { auth: "admin" }), method(object({
 	*
 	* ⚠ An earlier version of this comment blamed Zod stripping, and that
 	* was wrong — corrected 2026-08-26 after the hop map
-	* (`docs/design/2026-08-26-mappa-hop-argomenti.md`) traced the path.
+	* (`docs/design/2026-08-26-topic-hop-map.md`) traced the path.
 	* There is **no Zod parse at all** between the door and the engine: the
 	* dispatcher forwards the payload verbatim and UDS carries it whole. A
 	* field declared here reaches `SqliteSettingsBackend` either way.
@@ -16689,7 +16691,7 @@ method(object({
 * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
 * ends in a log line, and a log line is the thing the operator asked to stop
 * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
-* ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
+* ricontrolliamo tutti questi punti"* [can we instrument these errors in the meantime? That way next round we recheck all these points]. Reading them meant grepping Loki and
 * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
 * media blackout were both diagnosed. The counters stay; this is where they can
 * be READ.
@@ -18105,7 +18107,7 @@ var BrokerStatusSchema$1 = _enum([
 	"unreachable",
 	"tls-error"
 ]);
-var BrokerInfoSchema = object({
+var BrokerInfoSchema$1 = object({
 	id: string(),
 	name: string(),
 	url: string(),
@@ -18168,7 +18170,7 @@ var StatusSchema = object({
 	brokerCount: number(),
 	embeddedRunning: boolean()
 });
-method(_void(), array(BrokerInfoSchema)), method(IdInputSchema, BrokerConnectionDetailsSchema, { auth: "admin" }), method(AddBrokerInputSchema, AddBrokerResultSchema, {
+method(_void(), array(BrokerInfoSchema$1)), method(IdInputSchema, BrokerConnectionDetailsSchema, { auth: "admin" }), method(AddBrokerInputSchema, AddBrokerResultSchema, {
 	kind: "mutation",
 	auth: "admin"
 }), method(IdInputSchema, _void(), {
@@ -20382,78 +20384,16 @@ var NcRuleInputSchema = object({
 	*/
 	confirm: NcConfirmSchema.optional(),
 	/**
-	* WAIT for face/plate recognition before saying anything.
-	*
-	* A notification's TEXT is frozen at enqueue and its media is re-resolved at
-	* send; the identity is neither. A face is confirmed after `confirmFrames`
-	* agreeing observations — p50 **11.4 s** after the track was first seen,
-	* measured on this hub — and an `immediate` rule enqueues on the first object
-	* event, seconds before that. So "Gianluca è arrivato" is unsayable on the
-	* immediate path, and no amount of media re-resolution fixes a sentence.
-	*
-	* Only two honest answers exist, and this flag picks between them. It has
-	* effect ONLY on a rule that declares a recognition scope
-	* ({@link NcConditions.identities} or {@link NcConditions.plates}) — on any
-	* other rule there is nothing to wait for and the flag is inert.
-	*
-	* | value | what happens |
-	* | --- | --- |
-	* | `true` | the rule stops firing on the object event and fires at TRACK CLOSE instead, once, with the name — later, and complete |
-	* | absent / `false` | it fires at once WITHOUT the name, and if recognition lands before the track closes a SECOND, "…is Gianluca" notification follows (one per track, per rule, per target) |
-	*
-	* `.optional()` and deliberately NOT `.default()`: a Zod default does not run
-	* on the addon cap path, and absent has to keep meaning exactly what every
-	* rule authored before this field meant.
-	*
-	* The cost of `true` is stated here because the editor states it too: a rule
-	* that waits also inherits track-close SEMANTICS — its `zones` condition
-	* tests every zone the track visited and a `crossing` condition can no longer
-	* be satisfied, because a closed track carries no crossing.
+	* IMMEDIATE GROUPED (D692): the first matching subject opens a window of this many
+	* seconds; the rule sends ONE message when the window closes — early, once every
+	* subject in it is final, never before {@link NC_GROUPING_MIN_SEC} — naming everybody
+	* the rule matched, with one mosaic tile per subject.
+	* Absent = plain immediate (one message per track, at the first match).
+	* Only an `immediate` DETECTION rule may carry it (`ruleGroupingApplies`, enforced on
+	* save by the hub's grouping guard). `.optional()`, never `.default()`: the addon cap
+	* path does not run Zod defaults.
 	*/
-	waitForEnhancement: boolean().optional(),
-	/**
-	* GROUP a burst of subjects into ONE notification that grows.
-	*
-	* Seconds of quiet after the last matching subject before the burst is
-	* considered over. While it is open, the first subject enqueues immediately —
-	* **exactly as today, with no added latency** — and every real growth (a new
-	* subject, or a name confirmed on one already in it) REPLACES that
-	* notification with an updated one naming everybody. The push carries the
-	* group's own coalescing tag, so the phone replaces rather than stacks.
-	*
-	* `0` / absent = off, and off is today's behaviour byte for byte.
-	*
-	* ### Why an idle cutoff and not a window
-	*
-	* The measured seven-person arrival on device 590 spans 110 s with every
-	* internal gap under 30 s. A 12 s fixed window cuts it into three groups; an
-	* idle cutoff holds it as one and ends it when the arrival actually ends.
-	* 30 s is a widely shipped value for the same decision.
-	*
-	* ### What it replaces
-	*
-	* The blind cooldown, which collapses a burst by DISCARDING it. Measured on
-	* device 615 / *Persona su Uscio* over six days: 116 qualifying tracks → 74
-	* notifications, **44 (37.9%) suppressed outright**, 23 of them overlapping a
-	* track that did fire and 7 carrying a confirmed identity nobody heard about.
-	* A group collapses the same volume by MERGING, so the cooldown becomes a
-	* budget over GROUPS — which is what it always meant — and a growth is never
-	* throttled by the window its own first member spent.
-	*
-	* ### Interaction with {@link waitForEnhancement}
-	*
-	* They compose, and the order matters. `waitForEnhancement` defers the rule to
-	* TRACK CLOSE, so with both set the group is opened by the first member to
-	* CLOSE — already carrying its name — and grows as later members close. That
-	* is later, and complete. With grouping alone the group opens on the first
-	* object event and picks up names as they are confirmed, through the growth
-	* path. Neither combination fires twice for one subject.
-	*
-	* `.optional()` and deliberately NOT `.default()`: a Zod default does not run
-	* on the addon cap path, so absent must keep meaning what it meant before this
-	* field existed.
-	*/
-	groupIdleSec: number().int().min(0).max(600).optional()
+	groupingSec: number().int().min(5).max(60).optional()
 });
 /**
 * Partial patch for `updateRule` — any subset of the input fields, plus the
@@ -20501,9 +20441,10 @@ var NcRuleClearableKeySchema = _enum([
 	"targetUsers",
 	"snoozeOptions",
 	"snoozeAllowGlobal",
-	"waitForEnhancement",
 	"actions",
 	"confirm",
+	"groupingSec",
+	"waitForEnhancement",
 	"groupIdleSec"
 ]);
 var NcRuleUpdateInputSchema = object({
@@ -20525,9 +20466,25 @@ var NcRuleSchema = NcRuleInputSchema.extend({
 	*/
 	disabledTargetIds: array(string()).default([])
 });
+/**
+* The state-summary SECTIONS (D647 / D698): the D637 kind groups that report a
+* still-true state. `backups-exports` and `alarm` are not sections — a completed
+* job is not an open state, and the alarm stays instant.
+*/
+var NcStateSummarySectionIdSchema = _enum([
+	"device-state",
+	"streams",
+	"battery",
+	"consumables",
+	"tanks",
+	"detection-blind",
+	"nodes",
+	"addons",
+	"updates"
+]);
 /** One section of a previewed state summary. `unavailable` = its state could not be read. */
 var NcStateSummaryPreviewSectionSchema = object({
-	id: string(),
+	id: NcStateSummarySectionIdSchema,
 	status: _enum(["read", "unavailable"]),
 	items: number().int().nonnegative(),
 	reason: string().optional()
@@ -20537,7 +20494,7 @@ var NcStateSummaryPreviewSectionSchema = object({
 * a `rule` split (no `section`), one section's on a `section` split.
 */
 var NcStateSummaryPreviewRowSchema = object({
-	section: string().optional(),
+	section: NcStateSummarySectionIdSchema.optional(),
 	/** The section's name on a per-section row; every reported section's, joined, on a combined one. */
 	title: string(),
 	text: string(),
@@ -22436,14 +22393,14 @@ var TrackSchema = object({
 	* `derive-returned-null tile=standin`,
 	* `native-tile tile=native no-key-frame-at-close`, …) written at close and
 	* CLEARED by the late-keyFrame upgrade when a native tile lands after all.
-	* The operator-facing answer to "perché manca l'immagine?" on a track whose
+	* The operator-facing answer to "perché manca l'immagine?" [why is the image missing?] on a track whose
 	* tile is a face/plate stand-in, a raster crop, or an icon.
 	*
 	* **`no-key-frame-at-close` (D400).** The line used to be written ONLY when
 	* the TILE ranked below native, so a track whose thumbnail landed natively
 	* while its key frame missed carried no reason at all — three of the four
 	* `MISSING_KEYFRAME` tracks in the 2026-09-07 operator audit were exactly
-	* that shape, and their "niente ultimo" had no cause anywhere on the row.
+	* that shape, and their "niente ultimo" [no last frame] had no cause anywhere on the row.
 	* The key frame is the head of a cascade (`keyFrame ⇒ keyFrameSmall ⇒ the
 	* lastFrame copy source`), so its absence is now on this line whatever the
 	* tile ended up being.
@@ -22530,7 +22487,7 @@ var MotionEventSchema = object({
 	/**
 	* Ms offsets from `timestamp` (the episode's own first rising edge, so the
 	* first entry is always `0`) of every genuine off→on transition the
-	* episode saw — "ogni evento on si deve salvare" (D475). NOT one entry per
+	* episode saw — "ogni evento on si deve salvare" [every ON event must be saved] (D475). NOT one entry per
 	* push: a firmware source that keepalives at ~1 Hz for the whole burst
 	* (Reolink, Hikvision) produces exactly one edge; a source that reports an
 	* explicit `false` mid-episode and then resumes before the quiet window
@@ -23054,6 +23011,7 @@ var KeyEventSchema = object({
 	bestEventId: string(),
 	/** Track lifetime in ms (lastSeen - firstSeen). */
 	windowMs: number().optional(),
+	audioLabels: array(TrackAudioLabelSchema).readonly().optional(),
 	...TrackFlagFields,
 	...TrackRetrainFields
 });
@@ -27987,7 +27945,7 @@ var ClipPlaybackSchema = object({
 * **One authorised yes is one wake.** `next-natural` — take the clip the next
 * time the camera is awake for its own reasons — is deliberately not a member:
 * it was proposed, it is free on the battery, and the operator declined it on
-* 2026-09-20 (*"Quando un export viene richiesto si sveglia la camera."*,
+* 2026-09-20 (*"Quando un export viene richiesto si sveglia la camera."* [When an export is requested the camera wakes up],
 * D558 "Considered and not taken").
 */
 var ClipWakeSchema = _enum(["authorised"]);
@@ -28383,7 +28341,7 @@ var videoclipsCapability = {
 	* **It is a SECTION of the Recording tab, at the end of it — not a tab of
 	* its own.** It shipped as a `clips` top-tab and the operator rejected the
 	* placement: *"utilizzerei la stessa tab recordings, lì abbiamo già tutto il
-	* necessario, una nuova sezione alla fine per le clips"*. The Recording tab
+	* necessario, una nuova sezione alla fine per le clips"* [I would use the same recordings tab, there we already have everything necessary, a new section at the end for the clips]. The Recording tab
 	* already holds the recorder's panel, the schedule bands and the unified
 	* retention policy; footage the camera itself holds is the same question,
 	* asked of a different store. `order: 100` puts it after all of them with
@@ -28444,7 +28402,7 @@ var videoclipsCapability = {
 			* It replaced `sources?: string[]`, a VIEW filter over source ids that
 			* assumed the answer was a fan-out over everything a camera has. The
 			* operator settled otherwise on 2026-09-20 — *"l'utilizzatore è uno
-			* solo"* — so the list is asked of one provider at a time and there is
+			* solo"* [there is only one user] — so the list is asked of one provider at a time and there is
 			* nothing to filter out of it.
 			*/
 			provider: string().min(1)
@@ -36765,7 +36723,7 @@ var ReadGopBytesResultSchema = object({
 /**
 * A time WINDOW of one finalized segment, cut by byte range — the multi-GOP
 * twin of {@link ReadGopBytesResultSchema}'s single instant. Built for the
-* replay clip's `recording` source (`docs/design/plans/2026-08-26-replay-clip-su-pipeline.md`):
+* replay clip's `recording` source (`docs/design/plans/2026-08-26-clip-replay-on-pipeline.md`):
 * a replay needs several seconds of native pixels, not one frame.
 *
 * `ok.data` is standalone-demuxable, same as a GOP read. `ok.reachesRequestedEnd`
@@ -40496,6 +40454,7 @@ var zoneRulesCapability = {
 	*/
 	durability: "restored"
 };
+SOURCE_CAPS.filter((cap) => cap !== "switch" && cap !== "motion");
 /**
 * Accessory device helpers — shared across drivers.
 *
@@ -50760,6 +50719,11 @@ Object.freeze({
 	}
 });
 Object.freeze({
+	"accessories.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"accessories.setChildHidden": [{
 		name: "childDeviceId",
 		form: "single",
@@ -50779,6 +50743,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"airQualitySensor.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"alarmPanel.arm": [{
 		name: "deviceId",
 		form: "single",
@@ -50789,11 +50758,36 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"alarmPanel.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"alarmPanel.trigger": [{
 		name: "deviceId",
 		form: "single",
 		optional: false
 	}],
+	"ambientLightSensor.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"audioAnalysis.applyDeviceSettingsPatch": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"audioAnalysis.getDeviceLiveContribution": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"audioAnalysis.getDeviceSettingsContribution": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"audioAnalysis.resolveDeviceSettings": [{
 		name: "deviceId",
 		form: "single",
@@ -50834,16 +50828,36 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"automationControl.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"automationControl.trigger": [{
 		name: "deviceId",
 		form: "single",
 		optional: false
 	}],
+	"battery.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"battery.wakeForStream": [{
 		name: "deviceId",
 		form: "single",
 		optional: false
 	}],
+	"binary.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"brightness.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"brightness.setBrightness": [{
 		name: "deviceId",
 		form: "single",
@@ -50859,6 +50873,26 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"cameraCredentials.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"cameraGridLayout.applyDeviceSettingsPatch": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"cameraGridLayout.getDeviceLiveContribution": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"cameraGridLayout.getDeviceSettingsContribution": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"cameraGridLayout.getLayout": [{
 		name: "deviceId",
 		form: "single",
@@ -50874,6 +50908,21 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"cameraPipelineConfig.applyDeviceSettingsPatch": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"cameraPipelineConfig.getDeviceLiveContribution": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"cameraPipelineConfig.getDeviceSettingsContribution": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"cameraStreams.getBrokerStreams": [{
 		name: "deviceId",
 		form: "single",
@@ -50899,6 +50948,16 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"carbonMonoxide.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"climateControl.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"climateControl.setFanMode": [{
 		name: "deviceId",
 		form: "single",
@@ -50939,16 +50998,41 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"color.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"color.setColor": [{
 		name: "deviceId",
 		form: "single",
 		optional: false
 	}],
+	"connectivity.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"consumables.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"consumables.reset": [{
 		name: "deviceId",
 		form: "single",
 		optional: false
 	}],
+	"contact.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"control.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"control.setValue": [{
 		name: "deviceId",
 		form: "single",
@@ -50959,6 +51043,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"cover.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"cover.open": [{
 		name: "deviceId",
 		form: "single",
@@ -50984,6 +51073,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"dayNight.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"dayNight.setSettings": [{
 		name: "deviceId",
 		form: "single",
@@ -50994,11 +51088,31 @@ Object.freeze({
 		form: "single",
 		optional: true
 	}],
+	"detectionPipeline.applyDeviceSettingsPatch": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"detectionPipeline.getDeviceLiveContribution": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"detectionPipeline.getDeviceSettingsContribution": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"deviceAdminLink.getAdminLink": [{
 		name: "deviceId",
 		form: "single",
 		optional: false
 	}],
+	"deviceAdoption.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"deviceAdoption.release": [{
 		name: "camDeviceId",
 		form: "single",
@@ -51014,6 +51128,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"deviceDiscovery.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"deviceDiscovery.listDiscovered": [{
 		name: "deviceId",
 		form: "single",
@@ -51033,6 +51152,21 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"deviceExport.applyDeviceSettingsPatch": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"deviceExport.getDeviceLiveContribution": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"deviceExport.getDeviceSettingsContribution": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"deviceExtension.listCandidates": [{
 		name: "deviceId",
 		form: "single",
@@ -51381,6 +51515,26 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"deviceStatus.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"doorbell.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"enumSensor.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"eventEmitter.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"faceGallery.getFaceByTrack": [{
 		name: "deviceId",
 		form: "single",
@@ -51395,6 +51549,11 @@ Object.freeze({
 		form: "array",
 		optional: true
 	}],
+	"fanControl.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"fanControl.setDirection": [{
 		name: "deviceId",
 		form: "single",
@@ -51415,6 +51574,26 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"featureProbe.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"flood.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"gas.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"humidifier.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"humidifier.setMode": [{
 		name: "deviceId",
 		form: "single",
@@ -51430,11 +51609,26 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"humiditySensor.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"image.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"imageSettings.getOptions": [{
 		name: "deviceId",
 		form: "single",
 		optional: false
 	}],
+	"imageSettings.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"imageSettings.setSettings": [{
 		name: "deviceId",
 		form: "single",
@@ -51445,6 +51639,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"intercom.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"intercom.handleAnswer": [{
 		name: "deviceId",
 		form: "single",
@@ -51475,6 +51674,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"lawnMowerControl.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"lawnMowerControl.pause": [{
 		name: "deviceId",
 		form: "single",
@@ -51485,6 +51689,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"lockControl.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"lockControl.lock": [{
 		name: "deviceId",
 		form: "single",
@@ -51500,6 +51709,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"mediaPlayer.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"mediaPlayer.next": [{
 		name: "deviceId",
 		form: "single",
@@ -51560,6 +51774,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"motion.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"motion.isDetected": [{
 		name: "deviceId",
 		form: "single",
@@ -51570,11 +51789,31 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"motionDetection.applyDeviceSettingsPatch": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"motionDetection.getDeviceLiveContribution": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"motionDetection.getDeviceSettingsContribution": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"motionDetection.removeCamera": [{
 		name: "deviceId",
 		form: "single",
 		optional: false
 	}],
+	"motionTrigger.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"motionTrigger.setMotionTrigger": [{
 		name: "deviceId",
 		form: "single",
@@ -51585,6 +51824,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"motionZones.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"motionZones.setZone": [{
 		name: "deviceId",
 		form: "single",
@@ -51595,6 +51839,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"nativeObjectDetection.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"nativeObjectDetection.setEnabled": [{
 		name: "deviceId",
 		form: "single",
@@ -51610,6 +51859,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"navigation.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"navigation.goToPoint": [{
 		name: "deviceId",
 		form: "single",
@@ -51655,6 +51909,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"networkLink.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"networkQuality.getDeviceStats": [{
 		name: "deviceId",
 		form: "single",
@@ -51680,11 +51939,26 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"notifier.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"notifier.send": [{
 		name: "deviceId",
 		form: "single",
 		optional: false
 	}],
+	"numericSensor.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"osd.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"osd.setOverlay": [{
 		name: "deviceId",
 		form: "single",
@@ -51744,6 +52018,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"petFeeder.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"petFeeder.markFoodReplenished": [{
 		name: "deviceId",
 		form: "single",
@@ -51779,6 +52058,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"pipelineAnalytics.applyDeviceSettingsPatch": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"pipelineAnalytics.clearTrackRelation": [{
 		name: "deviceId",
 		form: "single",
@@ -51819,6 +52103,16 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"pipelineAnalytics.getDeviceLiveContribution": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"pipelineAnalytics.getDeviceSettingsContribution": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"pipelineAnalytics.getEventDensity": [{
 		name: "deviceId",
 		form: "single",
@@ -52034,6 +52328,11 @@ Object.freeze({
 		form: "single",
 		optional: true
 	}],
+	"pipelineOrchestrator.applyDeviceSettingsPatch": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"pipelineOrchestrator.assignAudio": [{
 		name: "deviceId",
 		form: "single",
@@ -52079,6 +52378,16 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"pipelineOrchestrator.getDeviceLiveContribution": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"pipelineOrchestrator.getDeviceSettingsContribution": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"pipelineOrchestrator.getPipelineAssignment": [{
 		name: "deviceId",
 		form: "single",
@@ -52199,11 +52508,31 @@ Object.freeze({
 		form: "single",
 		optional: true
 	}],
+	"powerMeter.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"presence.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"pressureSensor.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"privacyMask.getOptions": [{
 		name: "deviceId",
 		form: "single",
 		optional: false
 	}],
+	"privacyMask.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"privacyMask.setAudioEnabled": [{
 		name: "deviceId",
 		form: "single",
@@ -52254,6 +52583,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"ptz.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"ptz.goHome": [{
 		name: "deviceId",
 		form: "single",
@@ -52344,6 +52678,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"recordingArchive.applyDeviceSettingsPatch": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"recordingArchive.deleteFootprint": [{
 		name: "deviceId",
 		form: "single",
@@ -52364,6 +52703,21 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"recordingArchive.getDeviceLiveContribution": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"recordingArchive.getDeviceSettingsContribution": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"recordingArchive.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"recordingArchive.listOpsLog": [{
 		name: "deviceId",
 		form: "single",
@@ -52449,6 +52803,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"recordingOnboard.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"recordingOnboard.setSettings": [{
 		name: "deviceId",
 		form: "single",
@@ -52479,6 +52838,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"sceneMonitor.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"sceneMonitor.listScenes": [{
 		name: "deviceId",
 		form: "single",
@@ -52504,6 +52868,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"scriptRunner.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"scriptRunner.run": [{
 		name: "deviceId",
 		form: "single",
@@ -52514,11 +52883,31 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"smoke.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"snapshot.applyDeviceSettingsPatch": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"snapshot.getDebugState": [{
 		name: "deviceId",
 		form: "single",
 		optional: false
 	}],
+	"snapshot.getDeviceLiveContribution": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"snapshot.getDeviceSettingsContribution": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"snapshot.getSnapshot": [{
 		name: "deviceId",
 		form: "single",
@@ -52535,6 +52924,11 @@ Object.freeze({
 		form: "array",
 		optional: false
 	}],
+	"snapshot.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"snapshot.invalidateCache": [{
 		name: "deviceId",
 		form: "single",
@@ -52545,6 +52939,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"streamBroker.applyDeviceSettingsPatch": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"streamBroker.assignProfile": [{
 		name: "deviceId",
 		form: "single",
@@ -52560,6 +52959,16 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"streamBroker.getDeviceLiveContribution": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"streamBroker.getDeviceSettingsContribution": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"streamBroker.getStreamWithCodec": [{
 		name: "deviceId",
 		form: "single",
@@ -52620,16 +53029,46 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"streamParams.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"streamParams.setProfile": [{
 		name: "deviceId",
 		form: "single",
 		optional: false
 	}],
+	"switch.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"switch.setState": [{
 		name: "deviceId",
 		form: "single",
 		optional: false
 	}],
+	"tamper.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"temperatureSensor.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"update.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"vacuumControl.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"vacuumControl.locate": [{
 		name: "deviceId",
 		form: "single",
@@ -52665,6 +53104,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"valve.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"valve.open": [{
 		name: "deviceId",
 		form: "single",
@@ -52680,6 +53124,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"vibration.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"videoclips.dialClipStream": [{
 		name: "deviceId",
 		form: "single",
@@ -52715,6 +53164,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"waterHeater.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"waterHeater.setAway": [{
 		name: "deviceId",
 		form: "single",
@@ -52730,6 +53184,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"weather.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"webrtcSession.addIceCandidate": [{
 		name: "deviceId",
 		form: "single",
@@ -53467,7 +53926,7 @@ var PreviewTextField = string().max(200);
 * Whether the notification's preview is a STILL or a short animation.
 *
 * The operator's ask, verbatim: *"inviato come gif o video (come per le altre
-* rule)"* — the other rules already offer an animated preview, and a ten-hour
+* rule)"* [sent as a gif or video (as for the other rules)] — the other rules already offer an animated preview, and a ten-hour
 * night reads better as three seconds of motion than as one frame of it. Both
 * modes get the SAME treatment (blurred frame, large centred title); `'gif'`
 * simply applies it to a dozen frames sampled across the render and assembles
@@ -161136,37 +161595,37 @@ function buildOnboardWrites(patch, schedule) {
 //#endregion
 //#region src/battery-charging.ts
 /**
-* Da `adapterStatus` + `chargeStatus` alla sorgente di alimentazione.
-*
-* I due campi rispondono a DUE domande diverse, e confonderle è il bug che
-* questo modulo esiste per chiudere:
-*
-*  - `adapterStatus` — l'alimentazione è COLLEGATA? Il firmware manda 0/1/2
-*    (nessuna · adattatore DC · pannello solare) e il confine dell'hub lo
-*    traduce in `'none' | 'dc' | 'solarPanel'` (`mapHubChargeStatus` e
-*    `mapHubAdapterStatus` in `reolink-hub.ts`), perché il vocabolario del
-*    percorso standalone è già a stringhe.
-*  - `chargeStatus` — la CELLA cosa sta facendo? 0 ferma · 1 in carica ·
-*    2 carica completa.
-*
-* La vecchia derivazione consultava l'adattatore SOLO per cercarci 'solar', e
-* un DC collegato cadeva nel ripiego `'none'`. Due Argus 3E lo nascondevano per
-* caso: piene e collegate rispondono `chargeStatus: 2`, che il ramo `isCharging`
-* mappava su `'dc'` per la ragione sbagliata. La Argus MagiCam (batteryVersion
-* 1, firmware 2026) collegata in permanenza risponde `chargeStatus: 0`, e per
-* tutta la sua vita è stata riportata NON in carica.
-*
-* Che `adapterStatus` sia un segnale vero e non una costante è MISURATO: il
-* 2026-09-05 l'operatore ha staccato il device 3628 e il payload grezzo è
-* passato da `adapterStatus: 1` a `0`, con `chargeStatus: 0` da entrambe le
-* parti — cioè `chargeStatus` da solo NON distingue i due stati.
-*
-* Due campi assenti NON sono `'none'`: `'none'` è un negativo che il firmware
-* ha detto ("nessun adattatore, cella ferma"), l'assenza di entrambi è
-* `'unknown'` — lo stesso confine che `percentage` ha chiuso diventando
-* `nullable` (D315). Il chiamante (`mapBatteryInfo`) non arriva qui con un
-* push che non parla di alimentazione: `reportsPowerSource` lo filtra prima e
-* conserva la convinzione precedente.
+* From `adapterStatus` + `chargeStatus` to the power source.
+*
+* The two fields answer TWO different questions, and confusing them is the bug that
+* this module exists to close:
+*
+*  - `adapterStatus` — is the power CONNECTED? The firmware sends 0/1/2
+*    (none · DC adapter · solar panel) and the hub boundary
+*    translates it into `'none' | 'dc' | 'solarPanel'` (`mapHubChargeStatus` and
+*    `mapHubAdapterStatus` in `reolink-hub.ts`), because the vocabulary of the
+*    standalone path is already strings.
+*  - `chargeStatus` — what is the CELL doing? 0 stopped · 1 charging ·
+*    2 fully charged.
+*
+* The old derivation consulted the adapter ONLY to look for 'solar' in it, and
+* a connected DC fell into the fallback `'none'`. Two Argus 3E units hid it by
+* chance: full and connected they answer `chargeStatus: 2`, which the `isCharging`
+* branch mapped to `'dc'` for the wrong reason. The Argus MagiCam (batteryVersion
+* 1, firmware 2026) permanently connected answers `chargeStatus: 0`, and for
+* its whole life it was reported as NOT charging.
+*
+* That `adapterStatus` is a real signal and not a constant is MEASURED: on
+* 2026-09-05 the operator unplugged device 3628 and the raw payload
+* went from `adapterStatus: 1` to `0`, with `chargeStatus: 0` on both
+* sides — i.e. `chargeStatus` alone does NOT distinguish the two states.
+*
+* Two absent fields are NOT `'none'`: `'none'` is a negative the firmware
+* has stated ("no adapter, cell stopped"), the absence of both is
+* `'unknown'` — the same boundary `percentage` closed by becoming
+* `nullable` (D315). The caller (`mapBatteryInfo`) does not arrive here with a
+* push that says nothing about power: `reportsPowerSource` filters it out first and
+* keeps the previous belief.
 */
 function deriveChargingSource(adapterStatus, chargeStatus) {
 	if (adapterStatus === void 0 && chargeStatus === void 0) return "unknown";